Traduire votre premier fichier
Créez un catalogue source, récupérez les fichiers cibles en allemand et en français, puis traduisez une modification ultérieure du contenu source.
Ce guide vous accompagne pas à pas dans la configuration, la traduction et la récupération d’un fichier JSON en anglais. À la fin, vous disposez des fichiers dans les langues cibles sur disque et d’une base de référence pour les modifications à venir. Pour confier la configuration à un agent de programmation, consultez Configurer avec un agent de programmation.
Utilisez un petit répertoire de projet dans un environnement où Node.js et npm sont disponibles. Il vous faut également un compte Lingo.dev, l’autorisation de traduire avec un moteur de localisation activé et un quota de compte suffisant pour cette tâche.
Installer et se connecter #
npm install --global @lingo.dev/cli
lingo --version
lingo loginLa connexion ouvre le navigateur. Pour un exécuteur non interactif, fournissez plutôt LINGO_API_KEY via son gestionnaire de secrets. Une clé définie dans l’environnement est prioritaire sur les identifiants de connexion enregistrés : supprimez toute clé qui les remplace involontairement avant de vous connecter avec le compte d’une autre personne.
Créer le fichier source #
Créez un répertoire locales et enregistrez le contenu suivant dans locales/en.json :
{
"checkout": {
"title": "Review your order",
"submit": "Place order"
}
}Depuis la racine du projet, exécutez :
lingo init --source en --targets de,fr --files 'locales/en.json' --yes
lingo linkinit écrit .lingo/config.json et ajoute un bloc Lingo.dev à AGENTS.md pour indiquer aux agents de programmation qu’ils doivent lire les guides pour les agents de la CLI ; utilisez --no-agents-md pour ignorer cette étape. link vous permet de sélectionner l’organisation et le moteur de localisation, ou de les créer si vos droits d’accès le permettent. Un moteur de localisation fournit les modèles et les consignes linguistiques ; son identifiant est enregistré dans la configuration du projet, tandis que vos informations d’authentification restent séparées.
Ouvrez la configuration avant de poursuivre. Elle doit indiquer en comme langue source, de et fr comme langues cibles, et locales/en.json comme fichier source. Vérifiez aussi les ID de l’organisation et du moteur de localisation, surtout dans un projet copié ou un fork.
Traduire et récupérer #
lingo push --backfill-missing --waitLe remplissage rétroactif demande les fichiers cibles manquants. --wait attend, puis télécharge les résultats terminés. Un premier push simple sans Lockfile enregistre le contenu source au lieu de demander cette traduction initiale.
Laissez les fichiers cibles inchangés pendant que la commande attend : ce mode de récupération directe n’effectue pas la comparaison actualisée des modifications locales pour détecter les conflits, contrairement à la commande pull distincte. Si l’exécution est en attente de relecture ou signale des échecs, examinez son état avant de la considérer comme terminée.
Ouvrez locales/de.json et locales/fr.json. Vérifiez que les deux clés de checkout sont toujours présentes et lisez les valeurs traduites. Si vous ne pouvez pas évaluer une langue cible, faites appel à une personne qualifiée pour la relecture ou utilisez une mesure adaptée. Lors de l’intégration à une application, chargez également les fichiers avec son chargeur de ressources habituel.
Examinez .lingo/lock.json ainsi que les différences entre la source et les fichiers cibles. Regroupez les fichiers acceptés, la configuration et l’état de référence dans un même commit. Sans --wait, exécutez lingo pull ultérieurement depuis le même checkout et sur la même machine pour récupérer la dernière exécution enregistrée localement.
Mettre à jour le fichier source #
Modifiez une valeur ou ajoutez une clé dans locales/en.json, puis exécutez :
lingo push --waitLa mise à jour habituelle compare les modifications du contenu source à l’état de référence enregistré. Le remplissage rétroactif sert à récupérer les fichiers manquants, pas les nouvelles clés d’un fichier cible déjà existant.
Pour d’autres types de ressources ou structures de fichiers, consultez Configuration et Formats. YAML et Android XML nécessitent de sélectionner explicitement le format. Pour extraire les appels du code source React, poursuivez avec le guide de démarrage rapide React ; sélectionnez son catalogue JSONC dans la configuration, sans supposer que cet exemple JSON le sélectionne.