CLI
Traduisez les fichiers de votre projet, récupérez les résultats et tenez à jour les catalogues source utilisés par les applications React.
La CLI Lingo.dev relie les fichiers de votre projet à un moteur de localisation. Vous configurez les chemins des fichiers source et les langues cibles, envoyez le contenu sélectionné et récupérez les fichiers traduits. Les exécutions suivantes s’appuient sur l’état de référence enregistré du contenu source pour traiter les modifications.
@lingo.dev/cli installe l’exécutable lingo. Commencez par votre premier fichier pour suivre la procédure complète, de la configuration à la récupération des résultats.
Installez la version actuelle de @lingo.dev/cli et utilisez lingo --version pour enregistrer la version utilisée par votre projet. Pour lingo.dev@0.138.10 et ses projets i18n.json, consultez la Référence de la CLI v0.
Choisissez l’installation adaptée à votre façon de travailler #
Pour une dépendance du projet suivie dans le système de gestion de versions :
npm install --save-dev @lingo.dev/cli
npx lingo --help
npx lingo --versionPour un exécutable accessible dans l’ensemble du shell :
npm install --global @lingo.dev/cli
lingo --helpCe manuel utilise directement lingo. Si vous l’installez localement, lancez-le via votre gestionnaire de paquets. npx @lingo.dev/cli@latest et pnpm dlx @lingo.dev/cli@latest exécutent la dernière version sans installation persistante. Fixez une version si le comportement doit être identique en local et en CI ; les exemples de CI utilisent Node.js 22.
lingo update utilise la méthode d’installation détectée. Passez par le gestionnaire de paquets pour choisir une version précise ou si l’installation n’est pas reconnue ou est éphémère.
Traduisez des fichiers ou extrayez des messages #
Pour les ressources existantes, configurez les fichiers, authentifiez-vous et associez un moteur de localisation. La traduction s’effectue sur le serveur. push --wait attend la fin du traitement puis télécharge les résultats ; les commandes distinctes push et pull vous permettent de les récupérer plus tard.
Pour les appels dans le code source React, l’extraction crée localement des fichiers JSONC et des déclarations TypeScript. Elle ne traduit rien et n’installe aucun environnement d’exécution. Ajoutez le catalogue extrait à la configuration des fichiers pour le traduire, puis chargez-le via le workflow des catalogues de React.
Conservez l’état nécessaire aux mises à jour #
Un premier envoi simple stocke les octets du contenu source. Le Remplissage rétroactif crée les fichiers cibles manquants ; les envois simples suivants traduisent les modifications du contenu source. Conservez ensemble .lingo/config.json, .lingo/lock.json et les traductions acceptées dans le système de gestion de versions. Les identifiants et le pointeur vers la dernière exécution restent dans votre répertoire personnel.
Envoi, Récupération et Lockfile et cache expliquent les options de mode et de reprise. Commandes répertorie les commandes de configuration, de traduction et de maintenance des catalogues.