Traduire un fichier avec la CLI v0
Reproduisez une exécution sur un petit catalogue hérité avec une version de paquet fixe, puis examinez le résultat et le Lockfile.
Utilisez cette procédure pour un projet i18n.json déjà installé ou un jeu de test hérité isolé. Elle cible lingo.dev@0.138.10, dont le manifeste exige Node.js 18 ou une version ultérieure. Vérifiez d’abord node --version et la version de lingo --version installée. Pour les nouveaux projets, suivez le guide de démarrage rapide actuel.
Utiliser le paquet enregistré #
Pour un projet existant, conservez la dépendance à version fixe. Pour un jeu de test distinct, choisissez votre gestionnaire de paquets :
npm install --save-dev lingo.dev@0.138.10
pnpm add --save-dev lingo.dev@0.138.10
yarn add --dev lingo.dev@0.138.10
bun add --dev lingo.dev@0.138.10N’exécutez qu’une seule commande d’installation. Appelez le binaire local via npm exec -- lingo, pnpm exec lingo, yarn lingo ou bun run lingo. Dans les exemples ci-dessous, cet appel est abrégé en lingo. Sous Windows, une installation locale à version fixe et un appel via le binaire du gestionnaire de paquets permettent aussi de ne pas dépendre de la résolution des commandes par nom de paquet.
Créer le catalogue et la configuration #
Exécutez lingo init depuis le répertoire destiné à héberger le projet. Cette commande crée i18n.json ; si le fichier existe déjà, conservez-le plutôt que de le réinitialiser. Créez locales/en.json :
{
"welcome": "Welcome back",
"button.save": "Save changes"
}Utilisez le compartiment JSON correspondant :
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es"] },
"buckets": {
"json": { "include": ["locales/[locale].json"] }
}
}version désigne la version du schéma de configuration, et non celle du paquet. Ce modèle lit l’anglais dans locales/en.json et écrit l’espagnol dans locales/es.json.
Configurer le service de traduction #
Pour Lingo.dev, fournissez LINGO_API_KEY via le mécanisme de gestion des secrets de votre interpréteur de commandes. Ajoutez le engineId voulu à la configuration et assurez-vous que la clé permet de traduire via ce moteur de localisation. Si vous l’omettez, le service applique sa sélection implicite ; sa politique actuelle peut toutefois exiger un identifiant explicite.
La configuration v0 avec un fournisseur direct est une option distincte, qui nécessite des identifiants propres au fournisseur ou un service Ollama accessible. Sa référence de configuration détaille les champs. Ces champs ne doivent pas figurer dans la configuration JSON de la CLI actuelle.
Exécuter et examiner #
lingo runExaminez locales/es.json pour vérifier à la fois les clés et les valeurs effectivement traduites. Confirmez que le message d’enregistrement désigne toujours l’action prévue. Lors de l’intégration à une application, chargez le catalogue cible avec le chargeur de catalogues réellement utilisé par celle-ci. Committez ensemble le résultat accepté, la configuration et i18n.lock.
Une exécution normale sans modification de la source devrait conserver les valeurs cibles existantes. Des modifications de la source ou une exécution forcée peuvent les remplacer. Les exécutions limitées à une langue cible ou à certaines clés ne mettent pas à jour la référence source existante, et le mode figé peut initialiser un Lockfile manquant. Lisez la mise à jour de la référence avant de considérer qu’un résultat à portée limitée signifie que le projet est entièrement à jour.
Pendant le développement, lingo run --watch surveille les modifications de la source jusqu’à ce que vous l’arrêtiez avec Ctrl+C. Avant d’étendre le jeu de test, consultez l’adoption des traductions existantes et la gestion manuelle des traductions cibles.