YAML con raíz de idioma

Traduce los valores dentro de una raíz de idioma y cambia el nombre de esa raíz al idioma de destino.

Rails lee el idioma en 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 dentro de esa raíz y la cambia al idioma de destino para mantener las mismas rutas de búsqueda en todos los idiomas.

El contenedor de idioma y las rutas de los mensajes #

Un catálogo de origen puede contener tanto interpolaciones como ramas de plural:

yaml
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, de modo que el origen en inglés y el destino en español pueden compartir los mismos identificadores de mensaje. El contenedor de destino pasa a ser es; checkout, one y other se mantienen como 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 agrega todas las categorías que requiere el idioma de destino. Verifica cómo se muestran las cantidades y variables correspondientes en la aplicación antes de aceptar los recursos.

El analizador requiere un único par en la raíz, con una clave escalar y un mapeo debajo de ella. Se permite que el idioma esté vacío, pero se rechaza un mensaje escalar o una lista directamente debajo de la raíz. Divide los archivos YAML que contengan varios idiomas en archivos individuales por idioma, o usa 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 texto anidados se comparan según sus rutas dentro del 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 las anclas pasan por la serialización del árbol YAML, que puede normalizar el formato.

Al limitar el alcance por clave o término, se pueden seguir reutilizando las traducciones sin cambios si se proporciona un origen anterior. --key de la CLI usa su referencia guardada, y agregar --force no impide esa reutilización. Edita directamente el destino si necesitas una corrección puntual de redacción. Para regenerar el archivo después de cambiar las pautas, guarda los destinos aceptados y usa --force de archivo completo con un alcance definido y sin --key; luego revisa cada mensaje modificado.

Cuando se limita el alcance por clave, pueden omitirse las cadenas de texto del mapeo que queden fuera del alcance y no se hayan resuelto. 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 se pueda analizar correctamente, sobre todo al crear un nuevo idioma a partir de un alcance limitado.

Configura el idioma y el destino #

Configura format: "yaml-root-key" explícitamente para los archivos de origen .yml o .yaml. La extensión no permite identificar el contenedor de idioma. Configuración de la CLI y GitHub explican los patrones de archivos 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 cómo se escribe la ruta, no el idioma indicado dentro del YAML. Revisa tanto el destino como su raíz y luego carga un saludo y un mensaje en plural a través de Rails. Localiza 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 respaldo.