YAML

Traduce valores de cadena anidados en YAML sin cambiar las claves del catálogo y elige otro controlador cuando la raíz o el esquema tengan un significado especial.

El controlador de archivos yaml traduce valores de cadena en mapas y secuencias anidados. Conserva las claves que el código de la aplicación usa para las búsquedas, junto con los números y los valores booleanos. Úsalo para catálogos cuya estructura sea la misma en todos los idiomas.

Decide si el YAML genérico es la opción adecuada #

Por ejemplo, este catálogo agrupa mensajes del proceso de pago sin un contenedor de idioma:

yaml
checkout:
  title: Complete your order
  steps:
    - Review your items
    - Confirm delivery
  retries: 3

El controlador selecciona checkout.title y las dos cadenas de la secuencia. retries conserva su valor numérico. También se seleccionaría un identificador entre comillas, ya que es una cadena. Ten en cuenta esta diferencia al elegir qué datos incluir en el catálogo.

Usa YAML con idioma en la raíz para un contenedor en: de estilo Rails que deba cambiar al idioma de destino. El YAML genérico conserva en:, incluso si el nombre del archivo cambia a es.yml. En ese caso, Rails puede ignorar el contenido porque la raíz sigue indicando inglés.

Usa OpenAPI para una especificación de API. El YAML genérico también seleccionaría identificadores de operación, referencias y ejemplos cuyos valores sean cadenas. Una extensión .yml no permite distinguir para qué se usa el archivo.

Reutilización y reconstrucción #

El origen actual define el árbol de salida. Un origen anterior permite determinar si la cadena de cada ruta cambió, y el destino existente aporta los valores de las rutas coincidentes. Las nuevas traducciones reemplazan las cadenas modificadas; las cadenas sin cambios pueden conservar sus traducciones existentes, incluso cuando se seleccionan mediante un ámbito de claves o términos.

La CLI proporciona su versión de referencia guardada para --key, por lo que esa selección no permite regenerar de forma confiable el texto YAML que no ha cambiado. Agregar --force al mismo comando no cambia este comportamiento. Para hacer una corrección exacta, edita el destino directamente. Para regenerarlo, guarda los destinos aceptados y usa un --force de archivo completo con un ámbito definido, sin --key. Revisa todo el archivo después del reemplazo.

La reconstrucción usa un árbol de sintaxis YAML para conservar los comentarios y la estructura de anclas mientras reemplaza los valores. La serialización puede normalizar el formato. Los comentarios siguen siendo parte del documento, no instrucciones para quien traduce. Verifica los alias con la herramienta que procesa tu YAML, especialmente cuando un mismo valor aparece a través de varias referencias.

Una ejecución limitada a determinadas claves puede omitir una cadena de un mapa si queda sin resolver, está fuera del ámbito y no existe un valor de destino. Las cadenas de las secuencias conservan su valor de origen para evitar cambios de posición. Por eso, un ámbito parcial no garantiza que todas las cadenas del archivo estén traducidas.

Configura y carga el catálogo #

Establece format: "yaml" de forma explícita para los orígenes .yaml o .yml en la configuración de la CLI. La detección de push excluye los archivos YAML que no tengan un formato explícito. La GitHub App tiene su propia selección de repositorios.

Ajusta la ruta de destino al cargador de la aplicación. Un origen como config/locales/checkout.en.yml y otro ubicado en locales/en/checkout.yml requieren distintas formas de derivar la ruta. Las posiciones en las secuencias también identifican los mensajes: mover un elemento puede cambiar qué traducción existente le corresponde. Inspecciona el catálogo cargado después de hacer cambios estructurales. Para las búsquedas en Rails, la selección de idioma y el uso de un idioma alternativo, consulta Localiza una aplicación Rails y usa el controlador de YAML con idioma en la raíz.