Le CLI Lingo.dev relie votre base de code à un moteur de localisation via la configuration de votre projet. Chaque lingo push passe par votre moteur et applique automatiquement votre voix de marque, votre glossaire, vos règles et la configuration du modèle. Aucune modification du code, aucune nouvelle dépendance.
Ce qui change#
| Avant | Après | |
|---|---|---|
| Pipeline de traduction | Pipeline Lingo.dev par défaut | Votre moteur de localisation |
| Voix de marque | Aucune | Appliquée pour chaque langue cible |
| Glossaire | Aucun | Correspondance sémantique à chaque requête |
| Règles | Aucune | Incluses pour chaque langue cible |
| Sélection du modèle | Paramètre par défaut de Lingo.dev | Votre configuration de modèle avec solutions de repli |
| Contrôle qualité | Aucun | Vos évaluateurs IA configurés s’exécutent automatiquement |
Configuration#
Associer votre moteur
Exécutez lingo link à la racine de votre projet :
lingo linkChoisissez (ou créez) une organisation et un moteur de localisation. link écrit orgId et engineId dans .lingo/config.json — validez ce fichier pour que chaque exécution utilise le même moteur. Vous pouvez aussi retrouver l’identifiant d’un moteur dans le tableau de bord ; il commence par eng_ (par ex. eng_SxjMwMsfOIsvV1wh).
Authentification
lingo loginOuvre un navigateur pour vous authentifier et enregistre une session. Pour une utilisation en CI ou non interactive, utilisez plutôt une clé API :
lingo login --api-key lk_...…ou définissez-la comme variable d’environnement :
export LINGO_API_KEY="lk_..."Générez une clé API depuis la page API Keys du tableau de bord.
Push
lingo pushLe CLI envoie les fichiers source à votre moteur et réécrit automatiquement les traductions sur le disque, en appliquant votre voix de marque, votre glossaire, vos règles et la configuration du modèle.
Référence de configuration#
.lingo/config.json#
| Champ | Description |
|---|---|
orgId | Organisation propriétaire du moteur. Défini par lingo link. |
engineId | Moteur qui effectue la traduction (eng_...). Défini par lingo link. |
sourceLocale, targetLocales et files fonctionnent comme dans n’importe quel projet — voir Configuration.
Variables d’environnement#
| Variable | Obligatoire | Par défaut | Description |
|---|---|---|---|
LINGO_API_KEY | Pour CI | - | Votre clé API Lingo.dev (à la place de lingo login) |
LINGO_API_URL | Non | https://api.lingo.dev | URL de base de l’API personnalisée (pour l’auto-hébergement ou la préproduction) |
À quoi vous attendre#
Chaque traduction produite par le CLI passe par l’intégralité du pipeline de votre moteur :
- Voix de marque façonne le ton et le niveau de formalité pour chaque langue
- Entrées du glossaire imposent une terminologie exacte grâce à la correspondance sémantique
- Les règles appliquent des règles linguistiques spécifiques à chaque langue.
- Configurations de modèle sélectionnent le bon LLM avec des solutions de repli automatiques
- Évaluateurs IA évaluent automatiquement la qualité après chaque requête
Les traductions apparaissent dans Reports avec le type de déclencheur api, aux côtés des requêtes issues de l’API et des intégrations.
