Lockfile de la CLI v0
Utilisez la référence source de l’ancienne version pour comprendre les changements en attente et rétablir l’état sans masquer les traductions inachevées.
i18n.lock permet à v0 de distinguer le contenu source inchangé du texte à traduire. Conservez-le avec le contenu source et les traductions cibles acceptées qu’il décrit. Il ne consigne pas toutes les modifications manuelles des traductions cibles et ne prouve pas qu’une traduction est correcte.
Ce que le fichier consigne #
Dans lingo.dev@0.138.10, le fichier est au format YAML et contient version: 1 ainsi qu’une table de correspondance checksums. Chaque section externe contient le hachage d’un motif de chemin traité ; ses entrées associent les clés sources à des sommes de contrôle des valeurs sources calculées avec MD5. Laissez la CLI gérer ces entrées plutôt que de les créer manuellement.
Lorsqu’une somme de contrôle change, la clé correspondante, si elle est présente, peut être traduite. Des hachages de valeurs sources identiques peuvent aussi relier une nouvelle clé à une clé supprimée dans le même contexte de traitement, ce qui permet de réutiliser la traduction après un renommage. Aucun de ces mécanismes ne constitue une mémoire de traduction utilisable sans restriction entre fichiers.
Distinguer la traduction du remplacement de la référence #
| Opération | Effet |
|---|---|
lingo run | Traduit les différences calculées et met à jour l’état source. |
lingo run --force | Régénère la sortie sélectionnée sans s’appuyer sur le calcul habituel des différences. |
lingo lockfile | Ajoute les sections d’état source manquantes sans modifier les sections déjà renseignées. |
lingo lockfile --force | Remplace les sommes de contrôle sources à partir des fichiers actuels sans traduire les cibles. |
lingo run --frozen | Vérifie la synchronisation sans traduire, mais initialise d’abord la référence si elle est absente. |
Supposons que le texte anglais change après l’acceptation d’une traduction française. Remplacer sa somme de contrôle avec lockfile --force enregistre le nouveau texte anglais comme référence, même si la traduction française exprime encore l’ancien sens. La reconstruction ne doit donc pas servir de méthode habituelle pour faire disparaître un échec de synchronisation.
Les exécutions limitées à une langue cible ou à certaines clés peuvent écrire des traductions sans actualiser la référence source partagée existante. Une exécution ordinaire ultérieure peut traiter à nouveau le changement source et remplacer une correction apportée après cette exécution ciblée. Veillez à mettre en cohérence les sorties des langues concernées avant de mettre à jour la référence partagée.
Pour finaliser un changement source dans plusieurs langues :
- Gardez la même révision source et conservez
i18n.locktant qu’une sortie concernée reste inachevée. Utilisezlingo runpour une mise à jour ordinaire de l’ensemble du projet, ou les exécutions ciblées documentées lorsque les sorties nécessitent un travail et une relecture séparés. - Examinez la sortie de chaque langue couverte par le remplacement des sommes de contrôle sources, y compris les sorties que la dernière exécution ciblée n’a pas modifiées. Résolvez les échecs et mettez les corrections manuelles acceptées en cohérence avec cette source. Si une sortie reste obsolète ou incertaine, laissez la référence partagée en attente.
- Si le travail ciblé a laissé la référence existante inchangée et que toutes les sorties couvertes sont désormais acceptées, exécutez
lingo lockfile --forcedepuis la racine du projet souhaité. Cette commande remplace les sommes de contrôle sources sans traduire : ne l’utilisez donc pas pour vous dispenser de la relecture précédente et ne supposez pas que le dernier sélecteur de langue cible limite ce remplacement. - Examinez les différences du Lockfile et committez ensemble la révision source exacte, toutes les traductions cibles correspondantes acceptées et
i18n.lock. Une exécution ultérieure delingo run --frozenpeut vérifier la synchronisation par rapport à cette référence finalisée ; elle ne peut pas établir que les traductions cibles sont à jour ni attester leur qualité.
Le mode figé n’est pas strictement en lecture seule lorsque i18n.lock est absent. Il peut d’abord initialiser les sommes de contrôle, et la seule présence des clés cibles ne prouve pas que les traductions sont à jour. Établissez une paire source/cible fiable avant d’interpréter la réussite d’une vérification en mode figé comme une preuve de synchronisation.
Rétablir un état manquant ou en conflit #
Lorsque le Lockfile est absent, v0 ne régénère pas nécessairement toutes les traductions cibles présentes : sans somme de contrôle antérieure, il peut conserver leurs valeurs. Examinez les paires source/cible incertaines avant d’accepter une référence nouvellement créée. Traductions existantes décrit ce cas d’adoption.
En cas de conflit de fusion, mettez d’abord en cohérence les changements sources et cibles des deux branches. Restaurez un Lockfile fiable lorsque c’est possible. Si vous devez le reconstruire, relisez les paires de traduction effectives, car la reconstruction consigne l’état source sans indiquer si les traductions cibles sont à jour.
La procédure de réparation de l’ancien format YAML conserve la dernière occurrence de chaque entrée en double et signale les suppressions. Elle résout les doublons syntaxiques, mais ne détermine pas quelle branche contient la formulation correcte. Examinez les valeurs en conflit avant de committer le fichier réparé avec les sorties acceptées.