Idiomas

rendimiento habla inglés y español de México (es-MX).

En el navegador

La barra superior tiene un selector de idioma (ES / EN). La primera vez, el idioma sigue al del navegador; después, la elección se recuerda en ese navegador. Las fechas y los números también siguen al idioma.

El español es formal (usted) y traduce los términos técnicos: despliegue, construcción (build), versión, reversión, complemento, confirmación (commit), envío (push), solicitud de incorporación (pull request), cubeta (bucket), balanceador de carga, entrada (ingress), demonio (daemon).

En este libro

El libro también está en los dos idiomas: el selector está en su encabezado. La versión en español de una página vive junto a ella (page.es.md al lado de page.md, con mkdocs-static-i18n); una página que todavía no está traducida se muestra en inglés dentro del libro en español. Los títulos traducidos conservan su ancla en inglés (## Título {#english-title}), así que las ligas entre páginas funcionan en los dos libros.

En los correos

NOTIFY_LANG define el idioma de los correos de notificación: en (el predeterminado) o es.

Los mensajes de la plataforma

Lo que la plataforma escribe para las personas (las comprobaciones del entorno, los resultados de ejecuciones y versiones, los problemas, los errores de validación, los correos) se escribe en inglés con i18n.M, que es fmt.Sprintf y además marca el formato para traducirlo. Se traduce cuando se muestra, no cuando se crea:

• la API ve Accept-Language: es y traduce el JSON con el que responde: las oraciones (message, summary, details, error…) mediante los patrones del catálogo; las etiquetas cortas (name, title) palabra por palabra, o con un patrón solo cuando este tiene suficiente texto fijo propio, así el nombre de una aplicación nunca cambia;
• un mensaje en inglés ya terminado se compara con los formatos del catálogo y se arma el mensaje en español con los mismos valores, que pueden cambiar de lugar (%[2]s) y que a su vez se traducen; las listas (a; b) se traducen parte por parte.

Así también se traducen los mensajes guardados hace mucho, y el código que crea mensajes no necesita saber el idioma.

Agregar texto

• En la interfaz, escriba la frase en inglés dentro de t("…") (o tn(n, "uno", "varios") para una cantidad) y agregue su español en web/src/i18n/es.ts. npm run typecheck falla si una frase no tiene español o si sus {marcadores} no coinciden.
• En Go, cree el mensaje con M("formato %s", valor) y agregue el español del formato en internal/i18n/es.go. TestCatalog falla si un formato no tiene español o si tiene un número distinto de valores.