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.
{
"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>"
}
}{
"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 :
_fewet_manyen 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,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.