YAML

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

El procesador de archivos yaml traduce los valores de cadena en mapas y secuencias anidados. Conserva las claves que el código de la aplicación utiliza para las búsquedas, así como los números y los booleanos. Úsalo para catálogos cuya estructura se mantenga igual en todos los idiomas.

Decide si el YAML genérico encaja #

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 procesador selecciona checkout.title y las dos cadenas de la secuencia. retries sigue siendo un valor numérico. También seleccionaría un identificador entre comillas, porque es una cadena. Ten en cuenta esta diferencia al decidir qué datos incluir en el catálogo.

Usa YAML con idioma en la raíz para un contenedor en: al estilo de 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 el inglés.

Usa OpenAPI para una especificación de API. El YAML genérico también seleccionaría los identificadores de operaciones, las referencias y los ejemplos con valores de cadena. La extensión .yml no permite distinguir entre estos usos.

Reutilización y reconstrucción #

El origen actual define el árbol de salida. Un origen anterior permite determinar si ha cambiado la cadena en cada ruta, y el destino existente aporta los valores de las rutas coincidentes. Las nuevas traducciones sustituyen las cadenas modificadas; las cadenas que no han cambiado pueden conservar sus traducciones existentes, incluso cuando se seleccionan por 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 regenera de forma fiable el texto YAML que no ha cambiado. Añadir --force al mismo comando no cambia este comportamiento. Edita directamente el destino para hacer una corrección exacta, o guarda los destinos aceptados y usa un --force de archivo completo con un ámbito definido y sin --key para regenerarlo. Revisa todo el archivo después de sustituirlo.

La reconstrucción utiliza un árbol de sintaxis YAML para conservar los comentarios y la estructura de los anclajes al sustituir los valores. La serialización puede normalizar el formato. Los comentarios siguen siendo contenido del documento, no instrucciones de traducción. Comprueba los alias con el sistema que lee tu YAML, especialmente cuando un mismo valor aparece a través de varias referencias.

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

Configura y carga el catálogo #

Establece format: "yaml" explícitamente para los orígenes .yaml o .yml en Configuración de la CLI. La detección de archivos 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 a la que espera el cargador de la aplicación. Un origen como config/locales/checkout.en.yml y otro situado en locales/en/checkout.yml necesitan que sus rutas se deriven de forma distinta. Las posiciones de las secuencias también identifican los mensajes: mover un elemento de una secuencia puede cambiar qué traducción existente le corresponde. Revisa el catálogo cargado después de hacer cambios estructurales. Para las búsquedas de Rails, la selección de idioma y el uso de un idioma de respaldo, usa Localizar una aplicación Rails con el controlador de raíz de idioma.