YAML con raíz de idioma
Traduce los valores bajo una única raíz de idioma y cambia el nombre de esa raíz por el del idioma de destino.
Rails obtiene el idioma de la raíz de un archivo YAML. Un archivo llamado checkout.es.yml sigue definiendo recursos en inglés si su raíz es en:. El controlador yaml-root-key traduce los mensajes bajo esa raíz y la cambia al idioma de destino, manteniendo la coherencia de las rutas de búsqueda entre idiomas.
El contenedor de idioma y las rutas de los mensajes #
Un catálogo de origen puede contener tanto interpolaciones como ramas de plural:
en:
checkout:
greeting: Hello, %{name}
items:
one: One item
other: "%{count} items"Las rutas de los mensajes son checkout.greeting, checkout.items.one y checkout.items.other. No incluyen en, lo que permite que el origen en inglés y el destino en español compartan los mismos identificadores de mensaje. El contenedor de destino pasa a ser es; checkout, one y other siguen siendo claves.
La sintaxis de interpolación y los nombres de las categorías de plural forman parte del contrato de la aplicación. Traducir las palabras no configura las reglas de plural de Rails ni añade todas las categorías que necesita el idioma de destino. Comprueba cómo se muestran las cantidades y variables pertinentes en la aplicación antes de aceptar los recursos.
El analizador requiere un único par clave-valor en la raíz, con una clave escalar y un mapa como valor. Se permite que un idioma esté vacío, pero se rechazan los mensajes escalares o las listas directamente bajo la raíz. Divide los archivos YAML con varios idiomas en archivos individuales por idioma, o utiliza YAML genérico si quieres conservar todas las raíces sin cambios. No selecciones este controlador para una especificación OpenAPI.
Actualizaciones y alcance parcial #
Los valores de cadena anidados se comparan por sus rutas bajo el contenedor de idioma. El origen actual aporta la estructura; el origen anterior y el destino existente permiten conservar los valores que no han cambiado. Los comentarios y los anclajes pasan por la serialización del árbol YAML, que puede normalizar el formato.
Si se proporciona un origen anterior, también se pueden reutilizar las traducciones sin cambios al limitar el alcance por claves o términos. --key de la CLI utiliza su referencia guardada, y añadir --force no impide esa reutilización. Para corregir una redacción concreta, edita el destino directamente. Para regenerar el archivo tras cambiar las directrices, guarda los destinos aceptados y utiliza --force sobre el archivo completo con un alcance definido, sin --key; después, revisa cada mensaje modificado.
Cuando se limita el alcance por claves, pueden omitirse las cadenas de los mapas que queden sin resolver fuera de ese alcance. Los elementos de las secuencias conservan los valores de origen en lugar de cambiar de posición. Comprueba por separado que el contenido esté completo y que el análisis se haya realizado correctamente, sobre todo al crear un nuevo idioma a partir de un alcance reducido.
Configura el idioma y el destino #
Define format: "yaml-root-key" explícitamente para los orígenes .yml o .yaml. La extensión no permite identificar el contenedor de idioma. Configuración de la CLI y GitHub explican los patrones de archivo y la organización de los destinos.
La reconstrucción requiere un idioma de destino y falla si no se proporciona. localeFormat de la CLI cambia la escritura de la ruta, no el idioma indicado dentro del YAML. Revisa tanto el destino como su raíz y, después, carga un saludo y un mensaje en plural mediante Rails. Localizar una aplicación Rails explica cómo se relacionan estos archivos con la selección del idioma de las solicitudes, las funciones auxiliares y el comportamiento de los idiomas alternativos.