Ajouter et gérer les langues dans la CLI v0
Choisissez la variante linguistique souhaitée, ajoutez une langue cible à la configuration historique et vérifiez le comportement des fichiers et de l’application.
Dans la v0, locale.source désigne la langue d’origine et locale.targets sélectionne les langues cibles des traductions récurrentes. Choisissez la variante adaptée à votre lectorat, puis vérifiez que la configuration, les noms de fichiers, le backend et l’application l’utilisent de façon cohérente.
Ajouter une langue cible #
Pour ajouter l’allemand à l’espagnol et au français déjà pris en charge, modifiez i18n.json :
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}Exécutez le binaire v0 installé pour cette langue cible :
lingo run --target-locale deL’option remplace la liste des langues cibles pour cette exécution et permet de sélectionner une langue absente de la configuration. Ajoutez-la à la configuration pour les prochaines exécutions. Le modèle de fichiers séparés locales/[locale].json écrit locales/de.json ; vérifiez les valeurs et chargez ce fichier dans l’application avant d’activer l’allemand pour votre lectorat.
Si la langue cible est absente, toutes les clés sélectionnées doivent être traduites. Si elle est déjà présente, elle conserve normalement les valeurs existantes et reçoit les clés manquantes, mais une modification du contenu source peut tout de même nécessiter une nouvelle traduction. Évitez de combiner le premier ajout d’une langue avec un forçage généralisé si les autres langues déjà acceptées doivent rester inchangées.
Limiter une exécution à une langue cible ne met pas à jour la référence existante des sommes de contrôle du contenu source. Une exécution ordinaire ultérieure peut traiter à nouveau le contenu source modifié. Consultez donc les règles de finalisation avant de considérer qu’une relecture ciblée règle définitivement la question.
Préciser la région et le système d’écriture lorsque c’est pertinent #
{
"locale": {
"source": "en-US",
"targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
}
}Les variantes régionales permettent de distinguer les conventions demandées : color/colour en anglais, ordenador/computadora en espagnol et trem/comboio en portugais illustrent pourquoi le seul choix d’une langue peut ne pas suffire. L’usage dépend toujours du contexte ; une balise ne garantit pas que chaque expression générée convienne au public visé. Le chinois peut aussi nécessiter des distinctions de système d’écriture ou de région, comme zh-Hans ou zh-TW.
Consultez les listes de la version installée :
lingo show locale sources
lingo show locale targetsCes listes ne garantissent ni la prise en charge ni la qualité pour tous les backends. Testez la paire choisie sur une exécution limitée avant d’en élargir la portée, plutôt que de vous fier à un nombre de langues annoncé par le passé.
Distinguer l’identité linguistique de l’organisation des fichiers #
Le traitement historique normalise plusieurs notations propres aux plateformes pour les requêtes API. Les fichiers peuvent toutefois nécessiter des traits de soulignement ou des noms conformes aux conventions des ressources Android. Utilisez le paramètre de délimiteur et l’organisation propre au format, puis vérifiez l’emplacement réel des fichiers de sortie.
La traduction ne définit pas dir, ne dispose pas les commandes de l’interface en miroir et n’ajoute pas de routage. L’arabe, l’hébreu, le persan et l’ourdou nécessitent généralement un affichage de droite à gauche (RTL) ; vérifiez l’interface qui utilise le contenu, y compris les nombres et les identifiants intégrés. L’application doit à la fois reconnaître la nouvelle langue et charger son contenu.
Supprimer une langue cible #
Retirer un code de locale.targets empêche sa sélection lors des prochaines exécutions. Les fichiers existants restent en place. Décidez séparément de les conserver, de cesser de les diffuser ou de les supprimer. La purge est destructive et peut sélectionner du contenu source ; il ne s’agit pas de la même opération que le retrait d’une langue de la configuration.