Reprendre des traductions existantes dans la CLI v0
Ajouter les clés manquantes aux anciens catalogues tout en conservant les valeurs existantes et en établissant une référence fiable pour la source.
V0 peut utiliser des catalogues créés ailleurs. Son traitement différentiel habituel compare les clés source et cible, puis ajoute les entrées manquantes sans régénérer les valeurs existantes. Ce fonctionnement diffère du remplissage rétroactif des fichiers manquants dans la CLI actuelle.
Préserver le travail existant #
Configurez le compartiment du catalogue dans i18n.json et conservez une copie restaurable des traductions cibles acceptées. Vérifiez que les valeurs existantes sont de véritables traductions : des textes provisoires dans la langue source peuvent masquer les lacunes que vous souhaitez combler.
Par exemple, cette source comporte trois clés :
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}Une cible existante en espagnol en contient deux :
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}La tâche habituelle d’ajout des entrées manquantes ajoute button.cancel tout en conservant les valeurs existantes, sauf si des sommes de contrôle antérieures signalent une modification de la source qui nécessite une nouvelle traduction.
Lancer le traitement pour une seule langue et examiner les différences #
lingo run --target-locale esVérifiez les ajouts, les suppressions de clés qui ne figurent plus dans la source et les éventuelles valeurs régénérées pour les clés modifiées. Contrôlez la langue et le chargement dans l’application, puis committez le résultat accepté avec l’état du Lockfile.
Une exécution à portée limitée ne met pas à jour la référence existante des sommes de contrôle de la source. Un Lockfile inchangé ne prouve pas que toutes les langues correspondent à la source actuelle. Une exécution habituelle ultérieure peut traiter à nouveau les textes source modifiés ; suivez la procédure de stabilisation de la référence.
Lorsqu’aucune somme de contrôle antérieure n’existe pour une clé présente, 0.138.10 ne marque pas cette clé comme modifiée simplement parce que la somme de contrôle manque. L’absence de Lockfile n’impose donc pas de tout retraduire, mais ne prouve pas non plus que les traductions cibles existantes sont à jour. Examinez les paires incertaines avant de considérer la nouvelle référence comme faisant autorité.
Corriger séparément les problèmes connus #
Si une valeur existante est incorrecte, effectuez une correction manuelle ou demandez une actualisation ciblée :
lingo run --force --target-locale es --key button.cancelLe forçage peut écraser le travail manuel. Utilisez des clés préservées lorsqu’une valeur doit rester sous contrôle humain et prévoyez la relecture des modifications ultérieures de la source dans le cadre de cette responsabilité.