localize.dev

Docs / Traduire / JSON

Traduire les fichiers de locale JSON

Remplissez les traductions manquantes dans les fichiers JSON i18next, react-intl, vue-i18n, ngx-translate et Transloco, avec des espaces réservés, des messages ICU et toutes les formes plurielles dont chaque langue a besoin.

Comment ça marche

localize-dev translate lit le fichier JSON dans votre langue source, trouve les clés qui manquent à chaque autre langue et les écrit, dans l'ordre des clés du fichier source afin que les fichiers diffèrent proprement. Les traductions que vous avez déjà ne sont pas touchées.

Il connaît les conventions de chaque bibliothèque : i18next {{name}}, imbrication $t(key) et suffixes pluriels _one / _other, messages ICU de react-intl et next-intl, pluriels | de vue-i18n, liens @:key et littéraux {'@'}, et Laravel :name.

Avant et après

Sortie réelle de localize-dev translate --locales pl sur le premier fichier. L'anglais a deux formes plurielles. Le polonais en a quatre, donc _few et _many sont ajoutés.

locales/en.json
{
  "inbox": {
    "title": "Inbox",
    "welcome": "Welcome back, {{name}}",
    "unread_one": "{{count}} unread message",
    "unread_other": "{{count}} unread messages",
    "empty": "Nothing here yet. <1>Write a message</1>"
  }
}
locales/pl.json · polonais
{
  "inbox": {
    "title": "Skrzynka odbiorcza",
    "welcome": "Witaj ponownie, {{name}}",
    "unread_one": "{{count}} nieprzeczytana wiadomość",
    "unread_few": "{{count}} nieprzeczytane wiadomości",
    "unread_many": "{{count}} nieprzeczytanych wiadomości",
    "unread_other": "{{count}} nieprzeczytanych wiadomości",
    "empty": "Nic tu jeszcze nie ma. <1>Napisz wiadomość</1>"
  }
}

Ce qui reste intact

  • Espaces réservés, vérifiés : une traduction qui en ajoute, supprime ou renomme un est rejetée
  • Balises comme <1>…</1> pour <Trans>
  • Chaque forme plurielle utilisée par la langue : _few et _many en polonais, six formes en arabe
  • L'ordre des clés et l'indentation du fichier source

Erreurs courantes et comment elles sont évitées

Copie uniquement _one et _other

L'anglais a besoin de deux formes plurielles, donc un fichier avec _one et _other semble complet. Le polonais, le russe et l'arabe en ont besoin de plus, et i18next se rabat silencieusement sur _other. Chaque forme utilisée par la langue cible est écrite, et un pluriel n'est considéré comme traduit que lorsque toutes sont présentes.

Espaces réservés qui sont traduits

Lorsqu'on lui demande de traduire Welcome back, {{name}}, un modèle traduit parfois aussi name. Les espaces réservés sont masqués avant la traduction et vérifiés après. Une traduction qui les modifie est retentée, puis omise et signalée, jamais écrite.

Pluriels dans une phrase plus longue

Un pluriel ou un select ICU imbriqué dans un autre texte ne peut pas être séparé en toute sécurité. Les pluriels et les sélections de premier niveau sont traduits branche par branche ; les éléments imbriqués sont signalés afin que vous puissiez les traduire manuellement.

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.