任意の言語でサイトを編集する

言語の仕組み

英語がすべてのコンテンツファイルのソースです。各変更のたびに、CI が変更箇所をほかの6言語に翻訳し、サイトをビルドして jenksguo.pages.dev と jenksguo.xyz に公開します（数分; だれも手動でデプロイしません）。

引き続き、どの言語でも自分で書くことができます。

• 手作業での翻訳 — たとえば中国語のより良いサマリーです。英語の元テキストがそのアイテムで変更されるまで保持され、変更後はその言語が新しい英語から再翻訳されます。
• サイトのコピー（インターフェース文言） — メニュー、ページタイトル、1行のページイントロ、hero、ボタン、検索説明です。英語と中国語は手作業で作成します。英語の変更は自動的に日本語、フランス語、スペイン語、エスペラント語に翻訳され、繁體は中国語に追従します。別の言語での編集は、その元テキストが変更されるまで保持されます。

翻訳できるもの: 経験、学歴、コミュニティでの役割とプロジェクト、ロールレンズ、CV、主張、見解ページ、資格、講演と執筆、およびこのドキュメントです。Bot スキル、プロフィール、機能一覧、用語集は英語のみです。

コンソールで行う場合

1. https://admin.jenksguo.xyz/admin を開き、Google でサインインします。
2. コンテンツ: ファイルを開き、エディター上部で言語（中文、日本語、…）を選びます。各フィールドは English の下に英語が表示されます。テキストを変更して Save を選択します。バッジは、翻訳が最新か、手作業で編集されたものか、再翻訳待ちかを示します。
3. コピー: 言語を選び、単語またはキー（たとえば hero や career.intro）で検索し、テキストを変更して Save を選択します。編集を削除するには、フィールドを空にして保存します。

https://dev.jenksguo.pages.dev で結果を確認したい場合は、まず dev · preview で作業します。

エージェントから行う場合（MCP または REST）

エージェントには content スコープ（main に書き込むには publish も）が付いたトークンが必要です — 「AI エージェントにアクセス権を与える](/agents/docs/how-to/give-an-agent-access)」をご覧ください。

ツール	REST	説明
admin_read_translation	GET /api/admin/translation	英語フィールド、現在の翻訳とステータス
admin_write_translation	PUT /api/admin/translation	1言語のフィールドを保存します
admin_read_copy	GET /api/admin/copy	1言語のインターフェース文言（英語付き）
admin_write_copy	PUT /api/admin/copy	1言語のインターフェース文言を保存します

変更するフィールドだけを指定します。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

英語のサイトコピーを変更したときは、中国語も設定してください。どちらも手作業のソースです。