Modifier le site dans n’importe quelle langue

Comment fonctionnent les langues

L’anglais est la source de chaque fichier de contenu. Après chaque modification, le CI traduit les parties modifiées dans les six autres langues, génère le site et le publie sur jenksguo.pages.dev et jenksguo.xyz (quelques minutes ; personne ne déploie à la main).

Vous pouvez toujours écrire vous-même dans n’importe quelle langue :

• Une traduction manuelle — par exemple un meilleur résumé en chinois. Elle est conservée jusqu’à ce que l’anglais de cet élément change ; ensuite cette langue est à nouveau traduite à partir du nouvel anglais.
• Texte d’interface (site copy) — le texte de l’interface : menus, titres de pages, intros d’une ligne, hero, boutons et descriptions de recherche. L’anglais et le chinois sont rédigés à la main ; une modification en anglais est traduite automatiquement en japonais, français, espagnol et espéranto, et le chinois traditionnel suit le chinois simplifié. Une modification dans une autre langue est conservée jusqu’à ce que son texte source change.

Ce qui peut être traduit : expériences, formation, rôles dans la communauté et projets, « role lenses », CV, arguments, pages de point de vue, références, conférences et articles, ainsi que ces documents. Les compétences du bot, le profil, les capacités et le glossaire sont uniquement en anglais.

Dans la console

1. Ouvrez https://admin.jenksguo.xyz/admin et connectez-vous avec Google.
2. Contenu : ouvrez un fichier, puis choisissez une langue au-dessus de l’éditeur (中文, 日本語, …). Chaque champ affiche l’anglais sous English ; modifiez le texte et sélectionnez Save. Le badge indique si la traduction est à jour, modifiée manuellement ou en attente de retraduction.
3. Copy : choisissez une langue, recherchez un mot ou une clé (par exemple hero ou career.intro), modifiez le texte et sélectionnez Save. Videz un champ et enregistrez pour supprimer votre modification.

Travaillez d’abord sur dev · preview si vous souhaitez vérifier le résultat sur https://dev.jenksguo.pages.dev.

Depuis un agent (MCP ou REST)

L’agent a besoin d’un jeton avec l’étendue content (et publish pour écrire sur main) — voir Donner l’accès à un agent IA.

Outil	REST	Ce que cela fait
admin_read_translation	GET /api/admin/translation	Champs en anglais, traduction actuelle et statut
admin_write_translation	PUT /api/admin/translation	Enregistrer des champs dans une langue
admin_read_copy	GET /api/admin/copy	Texte d’interface dans une langue, avec l’anglais
admin_write_copy	PUT /api/admin/copy	Enregistrer le texte d’interface dans une langue

Ne fournissez que les champs que vous modifiez. Le Markdown doit conserver les titres en anglais, les blocs de code et les liens — traduisez le texte du lien, jamais une URL. Conservez exactement les {placeholders} dans le texte d’interface.

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"}'

Avec le 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

Lorsque vous modifiez la copie du site en anglais, définissez également le chinois : les deux sont des sources rédigées à la main.