Baiym's Blog

1. 准备空白私有仓库#

不要直接在 GitHub 上点 Fork（因为 GitHub 为了安全，不允许把 Fork 来的仓库直接改成 Private）。

正确做法：

1. 在本地找另一个文件夹，克隆官方内容模板：

1
git clone https://github.com/LyraVoid/Shirone-Content.git my-content
2
cd my-content
3
rm -rf .git

2. 去 GitHub 新建一个完全空白的仓库（比如叫 my-shirone-content），务必勾选 Private。

3. 把本地内容推送到你的私有仓库：

1
git init
2
git add .
3
git commit -m "init my private content repo"
4
git branch -M main
5
git remote add origin <你的私有仓库地址>
6
git push -u origin main

1. 创建连接配置文件#

在根目录新建 shirone.content.json，必须使用 Shirone 官方要求的 Schema 结构：

1
{
2
  "schemaVersion": 1,
3
  "source": {
4
    "type": "git",
5
    "url": "https://github.com/你的用户名/my-shirone-content.git",
6
    "ref": "main"
7
  },
8
  "mounts": {
9
    "content": "src/content",
10
    "data": "src/data",
11
    "assets": "src/assets",
12
    "public": "public"
13
  },
14
  "keep": [],
15
  "prune": true
16
}

2. 配置本地环境变量#

在根目录新建 .env，填入你本地内容仓库的绝对路径（使用正斜杠 /）：

1
CONTENT_DIR="D:/Code/my-content"

3. 防止私有内容被误传（非常关键！）#

打开根目录的 .gitignore，在末尾追加以下内容。因为 content:sync 会把文章同步到主题目录，如果不忽略，你的私有文章就会被推送到公开的主题仓：

1
src/content/
2
src/data/
3
.env

4. 测试本地预览#

在终端执行同步命令，把文章从私仓拉取过来：

1
pnpm content:sync
2
pnpm dev

打开 http://localhost:4321，如果能看到你的文章，说明本地架构已经彻底跑通了。

1. 生成细粒度 Token (Fine-grained PAT)#

去 GitHub -> Settings -> Developer settings -> Fine-grained personal access tokens。 生成一个 Token：

• Repository access：只选你的私有内容仓 my-shirone-content。
• Permissions：找到 Contents，设置为 Read-only。 复制这个以 github_pat_ 开头的 Token 保存好。

2. 修改 shirone.content.json 读取环境变量#

在根目录把 shirone.content.json 的 url 字段改为一个自定义变量名（比如 CONTENT_REPO_URL）：

1
{
2
  "schemaVersion": 1,
3
  "source": {
4
    "type": "git",
5
    "url": "${CONTENT_REPO_URL}",
6
    "ref": "main"
7
  },
8
  "mounts": {
9
    "content": "src/content",
10
    "data": "src/data",
11
    "assets": "src/assets",
12
    "public": "public"
13
  },
14
  "keep": [],
15
  "prune": true
16
}

3. Vercel 后台配置#

在 Vercel 项目 Settings -> Environment Variables 中，添加以下环境变量：

• Key: CONTENT_REPO_URL

• Value: https://你的用户名:你的github_pat_Token@github.com/你的用户名/my-shirone-content.git (注意：这里直接填入完整的带 Token 的 URL，Vercel 环境变量是安全的，不会泄露。不要加任何空格)

• Key: NODE_VERSION

• Value: 22

在 Settings -> Build & Development Settings 中，覆盖 Build Command 为：

1
pnpm content:sync && pnpm build

配置完成后，点击 Redeploy。如果一切顺利，你的博客就上线了！