Le CLI traduit d’une langue source vers une ou plusieurs langues cibles, toutes définies dans .lingo/config.json :
{
"sourceLocale": "en",
"targetLocales": ["de", "fr", "es", "ja"]
}Les fichiers source sont lus, jamais modifiés. Chaque langue cible génère sa propre sortie, avec le code de langue injecté dans le modèle de fichier (content/en/app.json → content/de/app.json). Voir Configuration.
Codes de langue#
Utilisez les balises standard BCP 47. Un code de langue simple (de) comme une balise langue-région (de-CH) fonctionnent. Le CLI ne s’appuie pas sur une liste figée : targetLocales accepte n’importe quelle balise et la transmet à votre moteur. Les langues effectivement prises en charge, ainsi que le niveau de qualité obtenu, dépendent de la couverture du modèle du moteur, et non d’une limite du CLI.
Exemples courants :
| Langue | Code |
|---|---|
| Anglais | en (ou en-US, en-GB) |
| Espagnol | es (ou es-ES, es-419, es-MX) |
| Français | fr (ou fr-FR, fr-CA) |
| Allemand | de (ou de-CH, de-AT) |
| Portugais | pt-BR, pt-PT |
| Chinois | zh-Hans, zh-Hant |
| Japonais | ja |
| Coréen | ko |
Variantes régionales#
Choisissez une région lorsque la variante linguistique a son importance : le moteur adapte alors l’orthographe et le vocabulaire à la langue concernée :
{
"sourceLocale": "en-US",
"targetLocales": ["en-GB", "es-ES", "es-419", "pt-BR", "pt-PT", "fr-CA"]
}en-US → en-GB transforme "color" en "colour" ; es-ES → es-419 remplace "ordenador" par "computadora". La qualité de ces nuances dépend de la voix de marque et des instructions du moteur, pas du CLI.
Langues s’écrivant de droite à gauche#
Les langues RTL (arabe ar, hébreu he, persan fa, ourdou ur) se traduisent comme toutes les autres. La direction du texte dans votre application relève de votre moteur de rendu ; le CLI se contente de produire les chaînes traduites.
Ajouter ou supprimer une langue#
Il suffit de modifier targetLocales. Pour remplir une langue nouvellement ajoutée, exécutez lingo push --backfill-missing — voir Ajouter une langue. Pour en supprimer une, retirez-la et supprimez ses fichiers avec lingo purge --locale.
