用任意语言编辑站点

语言如何运作

每个内容文件都以英文为源。每次更改后，CI 会将变更的部分翻译成另外六种语言，构建站点并发布到 jenksguo.pages.dev 和 jenksguo.xyz（需数分钟；无人手动部署）。

你仍然可以自行书写任意语言：

• 手工翻译——例如更优的中文摘要。在该条目的英文发生变化前，它会一直保留；随后该语言会根据新的英文重新翻译。
• 站点文案——界面文字：菜单、页面标题、单行页面引言、hero、按钮和搜索描述。英文与中文由人工撰写；英文更改会自动翻译为日语、法语、西班牙语和世界语，繁体中文跟随中文。对其他语言的编辑会保留，直到其源文本发生变化。

可翻译的内容：经历、教育、社区角色与项目、角色镜头、简历、论点、观点页面、证书、演讲与写作，以及这些文档。Bot 技能、个人资料、能力与术语表仅提供英文。

在控制台中

1. 打开 https://admin.jenksguo.xyz/admin 并使用 Google 登录。
2. 内容：打开一个文件，然后在编辑器上方选择一种语言（中文、日本語，…）。每个字段在 English 下方显示英文；修改文本并选择 Save。徽章会显示该翻译是最新、手工编辑，还是等待重新翻译。
3. 文案：选择一种语言，按词或键（例如 hero 或 career.intro）搜索，修改文本并选择 Save。清空字段并保存可移除你的编辑。

如果想先检查结果，请先在 dev · preview 上进行，在 https://dev.jenksguo.pages.dev 查看。

来自代理（MCP 或 REST）

代理需要具备 content 范围的令牌（写入 main 还需 publish）——参见 Give an AI agent access。

工具	REST	功能说明
admin_read_translation	GET /api/admin/translation	英文字段、当前译文与状态
admin_write_translation	PUT /api/admin/translation	保存某语言的一组字段
admin_read_copy	GET /api/admin/copy	某语言的界面文案，附带英文
admin_write_copy	PUT /api/admin/copy	保存某语言的界面文案

仅提交你更改的字段。Markdown 必须保留英文标题、代码块与链接——只翻译链接文本，切勿更改 URL。站点文案中的 {placeholders} 必须严格保留不变。

curl -X PUT https://jenksguo.pages.dev/api/admin/translation \
  -H "Authorization: Bearer $JENKSGUO_ADMIN_TOKEN" -H 'content-type: application/json' \
  -d '{"slug":"xero-developer-evangelist","locale":"zh","fields":{"summary":"…"},"branch":"dev","message":"Clearer Chinese summary"}'

使用 CLI

jenks admin tr get xero-developer-evangelist zh          # fields, status, current text
jenks admin tr put xero-developer-evangelist zh fields.json -m "Clearer Chinese summary" --branch dev
jenks admin copy get ja hero                             # interface text, filtered by key
jenks admin copy set en hero.sub "…" -m "Shorter intro" --branch dev
jenks admin copy set zh hero.sub "…" -m "Shorter intro" --branch dev

当你更改英文站点文案时，也请同时设置中文：二者都是人工撰写的源文本。