Dokumentaro / how to
Redaktu la retejon en ajna lingvo
Por Jenks kaj liaj agentoj — ŝanĝu enhavon kaj interfacan tekston en English, 中文, 繁體, 日本語, Français, Español aŭ Esperanto per la konzolo, la admin API, MCP aŭ la CLI, sen permane redeplojado.
Kiel funkcias la lingvoj
English estas la fonto de ĉiu enhava dosiero. Post ĉiu ŝanĝo, CI tradukas la ŝanĝitajn partojn al la ses aliaj lingvoj, konstruas la retejon kaj publikigas ĝin al jenksguo.pages.dev kaj jenksguo.xyz (kelkajn minutojn; neniu deplojas permane).
Vi ankoraŭ povas verki en ajna lingvo mem:
- Mane farita traduko — ekzemple pli bona ĉina resumo. Ĝi restas ĝis la English de tiu ero ŝanĝiĝas; tiam tiu lingvo estas retradukita el la nova English.
- Site copy — la interfaca teksto: menuoj, paĝotitoloj, la unu-liniaj paĝaj enkondukoj, la hero, butonoj kaj priskriboj por serĉo. English kaj Chinese estas verkitaj permane; ŝanĝo en English estas aŭtomate tradukita al Japanese, French, Spanish kaj Esperanto, kaj Traditional Chinese sekvas la Chinese. Redakto en alia lingvo restas ĝis ĝia fonta teksto ŝanĝiĝas.
Kio povas esti tradukita: spertoj, edukado, komunumaj roloj kaj projektoj, rol-lensoj, CV-oj, argumentoj, vidpunkto-paĝoj, atestiloj, paroladoj kaj verkoj, kaj ĉi tiuj dokumentoj. Bot skills, the profile, capabilities kaj la glosaro estas nur en English.
En la konzolo
- Malfermu
https://admin.jenksguo.xyz/adminkaj ensalutu per Google. - Content: malfermu dosieron, poste elektu lingvon super la redaktilo (中文, 日本語, …). Ĉiu kampo montras la English sub English; ŝanĝu la tekston kaj elektu Save. La insigno diras ĉu la traduko estas aktuala, permane redaktita aŭ atendanta esti retradukita.
- Copy: elektu lingvon, serĉu vorton aŭ ŝlosilon (ekzemple
heroaŭcareer.intro), ŝanĝu la tekston kaj elektu Save. Vakigu kampon kaj elektu Save por forigi vian redakton.
Laboru unue en dev · preview se vi volas kontroli la rezulton ĉe https://dev.jenksguo.pages.dev.
De agento (MCP aŭ REST)
La agento bezonas ĵetonon kun la amplekso content (kaj publish por skribi al main) — vidu Doni al AI-agento aliron.
| Ilo | REST | Kion ĝi faras |
|---|---|---|
admin_read_translation |
GET /api/admin/translation |
la kampoj en English, nuna traduko kaj stato |
admin_write_translation |
PUT /api/admin/translation |
Konservi kampojn en unu lingvo |
admin_read_copy |
GET /api/admin/copy |
Interfaca teksto en unu lingvo, kun la English |
admin_write_copy |
PUT /api/admin/copy |
Konservi interfacan tekston en unu lingvo |
Donu nur la kampojn kiujn vi ŝanĝas. Markdown devas konservi la English-titolojn, kodblokoj kaj ligilojn — traduku la ligilan tekston, neniam URL-on. Konservu {placeholders} en Site copy ekzakte.
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"}'
Per la 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
Kiam vi ŝanĝas la English site copy, metu ankaŭ la Chinese: ambaŭ estas permane verkitaj fontoj.
.mdĈi tiu paĝo estas tradukita kun helpo de AI; oficialaj titoloj restas en la angla.