用任何語言編輯網站

語言如何運作

每個內容檔案都以「英文」為來源。每次變更後，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 權杖範圍（以及 publish 以寫入 main）——請參閱授予 AI 代理存取權。

工具	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

當你修改英文網站文案時，也請一併設定中文：兩者都是手動撰寫的來源。