Documentación / Traducir / Rails YAML
Traducir archivos de localización YAML de Rails
Rellene config/locales/<lang>.yml para Rails y otros diccionarios YAML, manteniendo la interpolación %{name} y expandiendo los mapas plurales one/other a las formas de cada idioma.
Cómo funciona
localize-dev translate lee config/locales/en.yml, y archivos como devise.en.yml a su lado, luego escribe las claves faltantes en el archivo de cada idioma bajo su propia clave de localización. Un idioma sin archivo aún obtiene uno: devise.en.yml obtiene devise.pl.yml.
Se conservan los marcadores de posición de Rails %{name} y %<name>s, i18n-js {{name}} y printf. Un mapa de categorías de plural (one:, other:) se trata como un solo mensaje y se escribe con las categorías que utiliza el idioma de destino.
Antes y después
Salida real de localize-dev translate --locales pl en el primer archivo. El mapa de plurales items obtiene los few y many del polaco, y los valores que comienzan con % permanecen entre comillas.
en:
orders:
title: "Your orders"
shipped: "Shipped to %{city} on %{date}"
items:
one: "%{count} item"
other: "%{count} items"pl:
orders:
title: Twoje zamówienia
shipped: Wysłano do %{city} dnia %{date}
items:
one: "%{count} przedmiot"
few: "%{count} przedmioty"
many: "%{count} przedmiotów"
other: "%{count} przedmiotów"Lo que se mantiene intacto
- Interpolación
%{name}, comprobada después de la traducción - Mapas de plurales, con
few:ymany:añadidos donde el idioma los necesita - La anidación del archivo fuente, bajo la clave de idioma de destino
- YAML válido: los valores se citan donde YAML lo necesita
Errores comunes y cómo se evitan
Mapas de plurales con solo one y other
Rails elige la clave plural con las reglas del idioma. Si pl.yml solo tiene one y other, los recuentos como 3 o 25 no tienen forma propia. Se escribe cada categoría que utiliza el idioma.
Nombres de interpolación traducidos
%{city} tiene que seguir siendo %{city}, o Rails generará un error de interpolación faltante en tiempo de ejecución. Los marcadores de posición se enmascaran antes de la traducción y se comprueban después.
Comillas rotas
Un valor que comienza con % o contiene : necesita comillas, y una traducción editada manualmente las pierde fácilmente. El archivo está escrito por una biblioteca YAML, por lo que las comillas siguen las reglas de YAML.
Ejecutar
En la carpeta que contiene tus archivos de localización. Los idiomas que aún no tienen archivo obtienen uno. --dry-run muestra qué cambiaría primero.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deLuego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:
npx localize-dev check --only translationsGratis para 1000 cadenas al mes. Una cadena cuenta una vez sin importar en cuántos idiomas se incluya. Crea una cuenta gratuita
Guías para aplicaciones que usan este formato
Cuando el texto todavía está codificado en tu código, localize-dev run lo mueve a este formato primero.