Démarrage rapide

Mis à jour le : le trimestre dernier · 2 min de lecture

Déconseillé

Cette documentation couvre l’ancien CLI (v0). La version actuelle du CLI est la v1. Voir la documentation actuelle du CLI

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 :

bash
npm install -g lingo.dev

Vérifiez l’installation#

Vérifiez que le CLI est correctement installé :

bash
lingo --version

Le résultat devrait ressembler à ceci :

plaintext
lingo.dev v0.133.9
Node.js v20.10.0

Initialisez votre projet#

Placez-vous dans le répertoire de votre projet et exécutez :

bash
cd my-project
lingo init

Cette commande interactive vous permettra de :

  1. Connecter votre compte - Authentifiez-vous avec votre clé API
  2. Sélectionner un projet - Choisissez un projet existant ou créez-en un nouveau
  3. Configurer les langues - Sélectionnez les langues à prendre en charge
  4. 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 :

json
{
  "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 :

bash
lingo run

Le 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 :

bash
lingo run --watch

Appuyez sur Ctrl+C pour quitter le mode watch.

Besoin d’aide ?#

Vous avez besoin d’aide ?

bash
# Show help for all commands
lingo --help

# Show help for a specific command
lingo run --help

Rejoignez notre communauté Discord pour obtenir de l’aide en temps réel !

Étapes suivantes#