Ajouter une langue sans tout retraduire

Ajoutez une nouvelle langue cible, conservez les traductions acceptées et vérifiez que l’application peut utiliser les nouvelles ressources.

Ajouter une langue implique trois tâches : la sélectionner pour la traduction, créer les ressources et faire en sorte que l’application les charge. Ajouter une option de langue dans l’interface ne crée pas le catalogue correspondant. Traduire un catalogue ne suffit pas à le faire utiliser par la route.

Partez d’une source et de traductions cibles acceptées que vous pouvez restaurer. Notez la langue prévue, en précisant la région ou le système d’écriture si nécessaire. pt-BR et pt-PT désignent des publics différents, dont les attentes en matière de formulation peuvent varier.

Examiner l’organisation et les consignes existantes #

Répertoriez les motifs des fichiers sources, les cibles actuelles et les chemins de sortie attendus. Vous pouvez ajouter des fichiers cibles distincts indépendamment les uns des autres. En revanche, un catalogue de chaînes Xcode partagé regroupe plusieurs langues dans un seul fichier : l’existence du fichier ne suffit donc pas à établir la couverture.

Examinez la couverture des modèles, la terminologie, le registre et le ton pour le nouveau public. Ne réutilisez les consignes de langues voisines que si elles sont pertinentes. Un terme peut être commun à plusieurs langues, tandis que les conventions pour s’adresser au public diffèrent. La prise en charge des langues qui s’écrivent de droite à gauche exige aussi un travail sur le sens d’affichage et la mise en page de l’application, pas seulement sur la traduction des chaînes.

Ajouter la cible au projet CLI actuel #

Les cibles actuelles de la CLI sont définies par targetLocales dans .lingo/config.json. push ne propose ni option --target-locale ni option --locale. Dans un monorepo, vérifiez la configuration de projet sélectionnée par le répertoire de travail.

Avant d’ajouter la cible, terminez les mises à jour habituelles de la source encore en attente pour les langues existantes avec lingo push --wait. Achevez la relecture, récupérez les fichiers générés et comparez ces cibles à la source actuelle. Gardez cette révision de la source inchangée pendant l’ajout de la nouvelle langue.

Le remplissage rétroactif laisse les fichiers cibles existants inchangés. Lorsqu’il crée uniquement les fichiers de la nouvelle langue, il conserve une version de référence existante de la source, afin qu’un envoi habituel ultérieur puisse encore traiter les modifications en attente pour les autres langues. Terminer ces mises à jour en premier permet d’aligner les cibles existantes et nouvelles sur la même révision relue de la source.

Ajoutez ensuite la cible à la configuration du projet installé, authentifié et lié, puis examinez les opérations prévues pour les fichiers manquants :

sh
lingo push --backfill-missing --estimate
lingo push --backfill-missing --wait

L’estimation ne traduit rien et ne crée aucune tâche, mais elle téléverse les fichiers manquants sur le serveur pour planifier les opérations. Elle ne fonctionne pas hors ligne et ne garantit aucun prix. Le remplissage rétroactif parcourt les motifs configurés et crée les fichiers cibles manquants ; il ne renseigne pas les nouvelles clés dans une cible existante. Une fois la nouvelle langue à jour, les modifications habituelles ultérieures de la source utilisent lingo push --wait en s’appuyant sur la version de référence enregistrée.

Pour les catalogues XCStrings partagés, les opérations sont planifiées par langue au sein d’un même fichier ; examinez les nouvelles entrées à l’aide du workflow iOS.

Si la requête doit cibler une seule langue, restreignez targetLocales dans une branche contrôlée ou dans la configuration d’une tâche, puis rétablissez la liste complète. N’ajoutez pas l’option de forçage simplement pour cibler la nouvelle langue : elle retraduit les cibles existantes dans le périmètre concerné et peut remplacer des formulations déjà relues. Envoi explique ces distinctions ; la référence des langues de la CLI v0 présente les options de cette ancienne génération.

Fixer les mêmes limites à un assistant #

Un agent peut examiner l’organisation, proposer des consignes par langue et préparer les modifications de configuration. Précisez s’il peut modifier les fichiers locaux, les paramètres du moteur de localisation appartenant à l’organisation, ou les deux. Délégation distingue ces autorisations.

Demandez-lui d’expliquer quels modèles principaux et de repli s’appliquent, ainsi que les consignes communes et celles propres à chaque langue. Vérifiez l’état enregistré avant de comparer les résultats. Résolution de la langue explique la sélection ; une préférence de modèle n’est pas un indicateur de qualité linguistique.

Vérifier le résultat pour le nouveau public #

Comparez les chemins renvoyés et les différences au périmètre prévu. Les traductions cibles existantes et acceptées doivent rester inchangées, sauf si une mise à jour de la source ou une correction autorisée justifie la modification. Validez les variables, les branches de pluriel et les métadonnées de langue avec les outils de gestion des ressources de l’application.

Chargez du contenu représentatif dans la nouvelle langue. Vérifiez le mécanisme de repli, les débordements et le sens d’affichage, ainsi que le sens du texte. Conservez la révision de la source et le résultat pour la mesure avant d’étendre la couverture.

Retirer une langue de la configuration empêche sa sélection pour les nouvelles opérations ; cela ne supprime ni les ressources ni les routes utilisées à l’exécution. Décidez de ces modifications séparément, surtout lorsqu’un catalogue partagé contient à la fois la source et plusieurs langues.