Prenez en main le CLI en moins de 5 minutes.
Prérequis
Assurez-vous d’avoir Node.js 18.0 ou version ultérieure installé. Exécutez node --version pour vérifier.
Installation#
Installez le CLI globalement avec le gestionnaire de paquets de votre choix :
npm install -g lingo.devVérifiez l’installation#
Vérifiez que le CLI est correctement installé :
lingo --versionLe résultat devrait ressembler à ceci :
lingo.dev v0.133.9
Node.js v20.10.0Initialisez votre projet#
Placez-vous dans le répertoire de votre projet et exécutez :
cd my-project
lingo initCette commande interactive vous permettra de :
- Connecter votre compte - Authentifiez-vous avec votre clé API
- Sélectionner un projet - Choisissez un projet existant ou créez-en un nouveau
- Configurer les langues - Sélectionnez les langues à prendre en charge
- Définir la structure des fichiers - Choisissez où stocker les fichiers de traduction
Configuration créée
Le CLI crée un fichier i18n.json contenant vos paramètres. Vous pourrez le modifier plus tard si nécessaire.
Votre première traduction#
Créez un fichier de traduction simple :
{
"welcome": {
"title": "Welcome to Lingo.dev",
"subtitle": "The Localization Engineering Platform"
},
"auth": {
"login": "Log in",
"logout": "Log out"
}
}Lancez les traductions#
Traduisez votre contenu dans toutes les langues cibles configurées :
lingo runLe CLI va :
- ✅ Détecter vos fichiers source
- ✅ Calculer un delta par rapport au fichier de verrouillage
- ✅ Envoyer le contenu modifié à votre backend de traduction
- ✅ Écrire les traductions sur le disque
Mode watch (développement)#
En phase de développement, activez le mode watch pour relancer automatiquement les traductions à chaque modification des fichiers source :
lingo run --watchAppuyez sur Ctrl+C pour quitter le mode watch.
Besoin d’aide ?#
Vous avez besoin d’aide ?
# Show help for all commands
lingo --help
# Show help for a specific command
lingo run --helpRejoignez notre communauté Discord pour obtenir de l’aide en temps réel !
