localize.dev

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.

config/locales/en.yml
en:
  orders:
    title: "Your orders"
    shipped: "Shipped to %{city} on %{date}"
    items:
      one: "%{count} item"
      other: "%{count} items"
config/locales/pl.yml · polaco
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: y many: 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,de

Luego mantenlo completo en CI. Esto no necesita una clave API y falla cuando a un idioma le faltan traducciones:

npx localize-dev check --only translations

Gratis 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.