Purger les traductions avec la CLI v0
Supprimez les entrées gérées sélectionnées dans les catalogues et vérifiez le périmètre de suppression avant de les régénérer.
La purge v0 supprime les entrées gérées des catalogues. Elle n’effectue pas le nettoyage des fichiers et des verrous assuré par la CLI actuelle. Conservez des copies récupérables avant de l’exécuter : une purge sans filtre peut supprimer toutes les clés gérées des cibles configurées.
Sélectionner une seule cible et une clé #
Pour supprimer du catalogue français une clé à plat dont le nom exact est app.title :
lingo purge --locale fr --key app.titleVérifiez les clés et les chemins sélectionnés dans la demande de confirmation avant d’accepter. Dans cet exemple, le point fait partie de la clé à plat ; les représentations imbriquées dépendent du chargeur.
| Option | Sélection avec 0.138.10 |
|---|---|
--bucket json | Types de compartiments ; option répétable. |
--locale fr | Codes de langue ; option répétable. |
--file messages.json | Recherche de sous-chaînes dans les valeurs des motifs de chemin configurés. |
--key app.title | Motifs Minimatch correspondant aux clés gérées décodées. |
--yes-really | Ignorer la confirmation interactive. |
Le mécanisme de correspondance de la purge diffère de celui de run, qui recherche des clés ou des préfixes en tenant compte de leurs limites. Vérifiez les entrées sélectionnées plutôt que de vous fier au texte d’aide sur la correspondance ou de copier un sélecteur run --key.
Exclure explicitement la source #
Comparez la langue choisie à locale.source. Indiquer la langue source peut aussi entraîner la suppression du contenu source ; --locale ne garantit pas une sélection limitée aux cibles.
Gardez la confirmation interactive pour votre première vérification. N’utilisez --yes-really que dans une automatisation dont le périmètre exact de suppression a déjà été vérifié. Une exécution réussie ne dit rien sur la pertinence de ce périmètre.
Vérifier la suppression avant la régénération #
La purge écrit les catalogues sans reconstruire i18n.lock. Une exécution normale ultérieure détecte les cibles manquantes :
lingo run --target-locale frCette exécution peut aussi traiter d’autres modifications en attente pour le français. Examinez l’état de la source et les différences finales plutôt que de considérer cette exécution comme une unique demande de traduction.
Si la régénération échoue, les entrées supprimées restent absentes jusqu’à leur restauration ou leur régénération. Ne modifiez pas les sommes de contrôle pour simuler une suppression. Pour une valeur inchangée qui a simplement besoin d’une meilleure formulation, la retraduction forcée des éléments sélectionnés évite l’état intermédiaire où les résultats sont absents.