Editar el sitio en cualquier idioma

Cómo funcionan los idiomas

El inglés es la fuente de cada archivo de contenido. Después de cada cambio, el CI traduce las partes cambiadas a los otros seis idiomas, compila el sitio y lo publica en jenksguo.pages.dev y jenksguo.xyz (unos minutos; nadie despliega a mano).

Aun así, puedes escribir en cualquier idioma tú mismo:

• Una traducción a mano — por ejemplo, un mejor resumen en chino. Se mantiene hasta que cambie el inglés de ese elemento; entonces ese idioma se vuelve a traducir desde el nuevo inglés.
• Texto de la interfaz — el texto de la interfaz: menús, títulos de página, las introducciones de una línea de las páginas, el hero, botones y descripciones de búsqueda. El inglés y el chino se escriben a mano; un cambio en inglés se traduce automáticamente al japonés, francés, español y esperanto, y el chino tradicional sigue al chino. Una edición en otro idioma se mantiene hasta que cambie su texto fuente.

Qué se puede traducir: experiencias, educación, roles comunitarios y proyectos, lentes de rol, CVs, argumentos, páginas de punto de vista, credenciales, charlas y escritos, y esta documentación. Las habilidades del bot, el perfil, las capacidades y el glosario solo están en inglés.

En la consola

1. Abre https://admin.jenksguo.xyz/admin e inicia sesión con Google.
2. Contenido: abre un archivo y luego elige un idioma encima del editor (中文, 日本語, …). Cada campo muestra el inglés bajo English; cambia el texto y selecciona Save. La insignia indica si la traducción está al día, fue editada a mano o está a la espera de ser traducida de nuevo.
3. Texto de la interfaz: elige un idioma, busca una palabra o una clave (por ejemplo hero o career.intro), cambia el texto y selecciona Save. Vacía un campo y guarda para quitar tu edición.

Trabaja primero en dev · preview si quieres comprobar el resultado en https://dev.jenksguo.pages.dev.

Desde un agente (MCP o REST)

El agente necesita un token con el alcance content (y publish para escribir en main) — consulta Dar acceso a un agente de IA.

Herramienta	REST	Qué hace
admin_read_translation	GET /api/admin/translation	Campos en inglés, traducción actual y estado
admin_write_translation	PUT /api/admin/translation	Guarda campos en un idioma
admin_read_copy	GET /api/admin/copy	Texto de la interfaz en un idioma, con el inglés
admin_write_copy	PUT /api/admin/copy	Guarda el texto de la interfaz en un idioma

Indica solo los campos que cambias. Markdown debe mantener los encabezados en inglés, los bloques de código y los enlaces — traduce el texto del enlace, nunca una URL. Conserva {placeholders} en el texto de la interfaz exactamente.

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

Con 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

Cuando cambies el texto de la interfaz en inglés, establece también el chino: ambos son fuentes escritas a mano.