localize.dev

Docs / Traduire / Rails YAML

Traduire les fichiers de locale YAML de Rails

Remplissez config/locales/<lang>.yml pour Rails et d'autres dictionnaires YAML, en conservant l'interpolation %{name} et en développant les cartes plurielles one/other aux formes de chaque langue.

Comment ça marche

localize-dev translate lit config/locales/en.yml, et des fichiers comme devise.en.yml à côté, puis écrit les clés manquantes dans le fichier de chaque langue sous sa propre clé de locale. Une langue sans fichier en obtient un : devise.en.yml obtient devise.pl.yml.

Les espaces réservés Rails %{name} et %<name>s, i18n-js {{name}} et printf sont conservés. Une carte des catégories de pluriel (one:, other:) est traitée comme un seul message et écrite avec les catégories utilisées par la langue cible.

Avant et après

Sortie réelle de localize-dev translate --locales pl sur le premier fichier. La carte de pluriel items obtient les few et many du polonais, et les valeurs qui commencent par % restent entre guillemets.

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 · polonais
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"

Ce qui reste intact

  • Interpolation %{name}, vérifiée après traduction
  • Cartes de pluriel, avec few: et many: ajoutés là où la langue en a besoin
  • L'imbrication du fichier source, sous la clé de locale de la cible
  • YAML valide : les valeurs sont citées là où YAML en a besoin

Erreurs courantes et comment elles sont évitées

Cartes de pluriel avec seulement one et other

Rails choisit la clé de pluriel selon les règles de la langue. Si pl.yml n'a que one et other, les nombres comme 3 ou 25 n'ont pas de forme propre. Chaque catégorie utilisée par la langue est écrite.

Noms d'interpolation traduits

%{city} doit rester %{city}, sinon Rails déclenche une erreur d'interpolation manquante à l'exécution. Les espaces réservés sont masqués avant la traduction et vérifiés après.

Guillemets incorrects

Une valeur qui commence par % ou contient : nécessite des guillemets, et une traduction modifiée manuellement les perd facilement. Le fichier est écrit par une bibliothèque YAML, donc les guillemets suivent les règles de YAML.

Exécuter

Dans le dossier qui contient vos fichiers de langue. Les langues sans fichier en obtiennent un. --dry-run montre ce qui changerait en premier.

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

Ensuite, gardez-le complet dans la CI. Cela ne nécessite pas de clé API et échoue lorsqu'une langue manque de traductions :

npx localize-dev check --only translations

Gratuit pour 1 000 chaînes par mois. Une chaîne compte une fois, peu importe dans combien de langues elle va. Créez un compte gratuit

Guides pour les applications qui utilisent ce format

Lorsque le texte est encore codé en dur dans votre code, localize-dev run le déplace d'abord dans ce format.