La CLI de Lingo.dev conserve les modifications manuelles apportées aux fichiers cibles. Lorsque vous surchargez une traduction générée en modifiant directement le fichier cible, la CLI préserve votre changement lors des exécutions suivantes, tant que le contenu source n’a pas changé.
Comment fonctionnent les surcharges#
La CLI suit les empreintes du contenu source, pas celles du contenu cible. Lorsque vous modifiez manuellement une traduction dans un fichier cible, l’empreinte source reste inchangée : la CLI considère donc que la clé est déjà traduite et la saute.
La CLI génère une traduction
// locales/es.json (generated)
{ "greeting": "Bienvenido a nuestra plataforma" }Vous la surchargez manuellement
// locales/es.json (manually edited)
{ "greeting": "¡Bienvenido a nuestro espacio digital!" }Les exécutions suivantes conservent votre surcharge
npx lingo.dev@latest run
# Your custom translation remains unchangedQuand les surcharges sont remplacées#
Si le contenu source change, la CLI détecte une nouvelle empreinte et retraduit la clé, ce qui remplace votre surcharge :
// locales/en.json (source updated)
{ "greeting": "Welcome to our new platform" }La nouvelle empreinte ne correspond plus à l’entrée du lockfile, la CLI génère donc une nouvelle traduction pour cette clé.
Renommage de clés#
La CLI conserve les traductions même lorsque les clés sont renommées, tant que le contenu reste identique. Le lockfile suit à la fois les empreintes du contenu et celles des clés, ce qui permet le renommage de clés sans perdre le travail de traduction.
