Retraduire le contenu sélectionné avec la CLI v0
Actualisez les anciennes traductions après une modification de la source ou des consignes, tout en maîtrisant le périmètre et en préservant les modifications acceptées.
Lancez une exécution ordinaire lorsque le contenu source change. Utilisez le mode forcé lorsque la source reste inchangée, mais que la traduction doit prendre en compte de nouvelles instructions ou remplacer une valeur insatisfaisante. Dans les deux cas, les modifications manuelles ordinaires peuvent être écrasées.
Laissez les changements de la source déterminer ce qu'une exécution ordinaire doit traiter #
lingo run| État de la source et de la cible | Résultat d'une exécution ordinaire en v0 |
|---|---|
| La valeur source a changé par rapport à sa somme de contrôle précédente | Traduire la valeur modifiée. |
| Une clé source est absente de la cible | Traduire le contenu manquant. |
| Une clé source a été supprimée | Supprimer l'entrée cible gérée correspondante. |
| La valeur source d'une nouvelle clé a la même somme de contrôle que celle d'une clé supprimée | Réutiliser la traduction dans le contexte traité. |
| Cible présente et source inchangée | Conserver la valeur cible. |
Une correction manuelle ordinaire est conservée tant que la source reste inchangée, mais pas nécessairement lors des mises à jour suivantes. Les clés préservées réservent une valeur distincte sous contrôle humain.
Actualisez une traduction concernée #
Après avoir modifié un modèle, un prompt, un glossaire ou une règle, commencez par la langue et la clé concernées :
lingo run --force --target-locale es --key welcome/titleIci, welcome/title cible title dans welcome. Dans 0.138.10, run accepte les clés exactes, les préfixes qui respectent les limites des clés et les motifs glob. Placez --key 'welcome/**' entre guillemets pour sélectionner les descendants sans expansion par le shell.
Comparez la traduction à sa source, puis chargez-la dans l'application. Un traitement limité à une langue ou à une clé n'actualise pas la référence partagée existante. Suivez les règles de consolidation du Lockfile pour éviter qu'une exécution ordinaire ultérieure ne traite à nouveau, de façon inattendue, le même changement de la source.
Sélectionnez un volume de travail maîtrisable dans un grand projet #
--target-locale, --bucket, --file et --key sont des sélecteurs utilisables plusieurs fois. --source-locale modifie la source utilisée pour l'exécution. Partez de l'inventaire des groupes de formats et des chemins configurés, puis restreignez la sélection plutôt que de désigner un fichier arbitraire non configuré.
lingo run --target-locale es --bucket json --file 'apps/web/**'Le sélecteur de fichiers de run accepte les correspondances par sous-chaîne ou par minimatch sur les chemins configurés détectés. Celui de purge n'accepte que les correspondances par sous-chaîne ; son sélecteur de clés est également différent. Ne réutilisez pas les sélecteurs d'une commande dans l'autre sans vérifier les entrées sélectionnées.
Pour élargir délibérément l'actualisation :
lingo run --force --bucket json --target-locale esCette opération peut régénérer tout le contenu JSON espagnol sélectionné. lingo run --force seul couvre le projet configuré. Préservez les résultats acceptés avant d'élargir le périmètre et établissez une estimation pour ce même périmètre forcé lorsque vous utilisez le service Lingo.dev.
Pour les changements importants, séparer les périmètres par fichier et par langue facilite la relecture des différences. Après un échec, conservez les résultats des lots réussis et réessayez sur le périmètre concerné avant de tout forcer. Le traitement parallèle contrôle le débit, pas la sélection ni le retour arrière.
Conservez les catalogues d'interface et les documents dans leurs groupes de formats respectifs, en excluant le contenu généré et les brouillons. Utilisez des configurations de paquets distinctes lorsque les cibles ou les moteurs de localisation diffèrent. En CI, lingo run --frozen vérifie une référence fiable sans traduire ; analysez les échecs plutôt que de recalculer les sommes de contrôle pour les masquer. La procédure d'exécution actuelle utilise un autre paquet et une autre configuration : effectuez donc la migration avant de l'adopter.
N'utilisez purge que si vous souhaitez supprimer du contenu #
L'ancienne technique consistant à lancer purge puis run supprime les clés cibles pour que le traitement ordinaire du contenu manquant les prenne en charge. Elle supprime les résultats avant que la régénération ne réussisse, sans gain de performance établi. Consultez la référence de purge pour vérifier ses sélecteurs spécifiques et le risque pour la langue source ; conservez une copie récupérable jusqu'à ce que la régénération et la relecture aient réussi.