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.
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"Ce qui reste intact
- Interpolation
%{name}, vérifiée après traduction - Cartes de pluriel, avec
few:etmany: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,deEnsuite, 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 translationsGratuit 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.