Référence de la CLI v0
Assurez la maintenance d'un projet i18n.json déjà installé tout en préservant ses traductions acceptées et l'état de référence de ses sources.
Ce manuel porte sur l'ancien paquet lingo.dev et son workflow i18n.json/i18n.lock. Les exemples concernent uniquement 0.138.10. Conservez la version enregistrée dans le Lockfile du projet existant pendant que vous préparez une migration ; installer une version désignée comme la dernière, mais susceptible de changer, ne garantit pas une récupération reproductible.
Pour un nouveau projet, partez de la CLI actuelle. Son workflow d'envoi et de récupération côté serveur applique des règles différentes de gestion de l'état et de sélection.
Comment se déroule une exécution avec la v0 installée #
La configuration du compartiment sélectionne un analyseur et repère les fichiers source et cible, en développant [locale] au besoin. L'analyseur extrait le contenu et sépare les valeurs reconnues comme non traduisibles. Le calcul des différences compare les valeurs source, les cibles existantes et les sommes de contrôle antérieures des sources pour repérer les entrées nouvelles, modifiées, supprimées ou renommées.
Le texte sélectionné passe par un moteur de localisation Lingo.dev ou par un fournisseur direct configuré. Les traductions renvoyées sont réassemblées dans les fichiers cibles ou dans les sections par langue d'un fichier partagé. Certaines tâches peuvent écrire leurs résultats avec succès avant qu'une autre échoue ; le projet dans son ensemble n'est pas une transaction atomique.
Conservez l'état de référence avec le contenu #
Faites un commit regroupant i18n.json, les traductions acceptées pour chaque langue et i18n.lock. Le Lockfile enregistre l'état des sources, et non chaque modification des cibles ou chaque approbation linguistique. Les exécutions ordinaires mettent à jour les sommes de contrôle des sources ; les exécutions limitées à une langue cible ou à certaines clés peuvent écrire des résultats sans actualiser l'état de référence existant.
La référence du Lockfile explique pourquoi une exécution ordinaire ultérieure peut traiter à nouveau une modification de la source après une exécution à périmètre limité. La section Traductions existantes explique comment les adopter sans remplacer toutes les valeurs déjà présentes.
Choisissez la prochaine opération #
Suivez la procédure pour un premier fichier afin de reproduire une petite exécution avec l'ancienne version. Les sections Configuration et Formats précisent ce que la version installée lit et écrit.
Pour le travail courant, la section Langues explique comment ajouter une langue cible ; Contrôles des clés distingue les modifications ordinaires des valeurs sous contrôle humain ; Retraduction définit le périmètre d'une actualisation volontaire. Les sections Monorepos et Traitement parallèle abordent la répartition des responsabilités et le débit, sans supposer que multiplier les processus de traitement élimine les limites des fournisseurs.