Installez la CLI Lingo.dev, configurez votre projet et générez vos premières traductions.
Prérequis
Node.js 18 ou version ultérieure est requis. Exécutez node -v pour vérifier votre version.
Étape 1. Initialiser un projet#
Accédez à votre projet
cd your-project-directoryExécutez la commande d’initialisation
npx lingo.dev@latest initUtilisateurs Windows : si npx lingo.dev ne fonctionne pas, installez d’abord le package avec npm install lingo.dev@latest, puis utilisez npx lingo à la place.
Suivez les instructions. La CLI crée un fichier de configuration i18n.json à la racine de votre projet.
Étape 2. Configurer un bucket#
Dans i18n.json, configurez au moins un bucket : un format de fichier associé à des motifs d’inclusion qui indiquent à la CLI où se trouve le contenu à traduire :
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["locales/[locale].json"]
}
}
}L’espace réservé [locale] est remplacé par les codes de langue que vous avez configurés au moment de l’exécution : locales/en.json pour la source, locales/es.json pour l’espagnol, et ainsi de suite.
Pour consulter la liste complète des formats de fichier pris en charge et la configuration de leurs buckets, voir Supported Formats.
Étape 3. Connecter un backend de traduction#
La CLI a besoin d’un backend de traduction pour générer les traductions. Deux options :
Un moteur de localisation sur Lingo.dev applique automatiquement la voix de marque, le glossaire, les instructions et la configuration du modèle à chaque requête de traduction.
Créez un compte et générez une clé API depuis la page API Keys.
Définissez la clé API comme variable d’environnement :
export LINGO_API_KEY="your-api-key"Aucune configuration supplémentaire n’est nécessaire : la CLI utilise le moteur de localisation par défaut de votre organisation. Pour cibler un moteur précis, ajoutez engineId à votre i18n.json :
{
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Étape 4. Générer les traductions#
npx lingo.dev@latest runLa CLI détecte vos fichiers source, extrait le contenu à traduire, l’envoie vers le backend de traduction configuré, puis écrit les résultats sur le disque. Un fichier i18n.lock est créé pour suivre ce qui a été traduit : validez-le avec vos fichiers de langue.
