Configuration de la CLI v0

Configurez les anciens compartiments, les chemins par langue et les services de traduction sans mélanger les générations.

lingo.dev@0.138.10 lit i18n.json dans le répertoire de travail. Un compartiment définit son analyseur et détecte les fichiers ; les paramètres de langue précisent la source et les cibles. Ce contrat de configuration est distinct de celui de la version actuelle de .lingo/config.json.

Déclarer les langues et les compartiments #

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "lockedKeys": ["brand/name"],
      "ignoredKeys": ["internal/*"],
      "preservedKeys": ["legal/terms"]
    },
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

Les chemins sont résolus par rapport à la configuration. La clé du compartiment détermine l'analyseur, et non l'extension du fichier. Consultez l'ancienne matrice des formats et des sorties lorsqu'un format stocke plusieurs langues dans un même fichier.

Le champ version indique la génération du schéma. Une migration de l'ancien schéma peut mettre à jour ce fichier sans passer à la CLI actuelle. Conservez la configuration précédente et examinez chaque modification générée.

Définir les correspondances de chemins avec précision #

[locale] est remplacé par le code de la langue source ou cible. Un séparateur propre au chemin permet de gérer les noms de fichiers contenant des tirets bas :

json
{
  "include": [
    "standard/[locale].json",
    { "path": "legacy/[locale].json", "delimiter": "_" }
  ]
}

Pour en-US, le second chemin utilise legacy/en_US.json. La représentation dans les noms de fichiers est distincte des valeurs de langue normalisées envoyées au service.

La détection récursive de ** est disponible à partir de 0.135.0 ; les versions antérieures nécessitent des chemins explicites. Par défaut, elle exclut node_modules, .git, dist, build, .next et .turbo. Ajoutez des exclusions pour les autres arborescences générées.

Définir le comportement des clés #

Les anciens contrôles des clés utilisent des chemins de parcours séparés par des barres obliques et des correspondances avec des caractères génériques. modules/ai.translation sélectionne la clé littérale contenant des points dans modules. Le verrouillage copie les valeurs source, l'exclusion les omet de la sortie et la préservation initialise les valeurs manquantes à partir de la source, puis en laisse la gestion aux personnes chargées de la traduction. injectLocale sélectionne les clés de sortie pour le code de la langue cible.

Consultez Contrôles des clés pour connaître les effets exacts. Une instruction de traduction ne protège pas la structure, et un texte provisoire dans la langue source doit encore être traduit par une personne avant utilisation.

Choisir un moteur de localisation ou un fournisseur direct #

Avec un identifiant d'authentification Lingo.dev, engineId sélectionne le glossaire, les règles, le ton et les modèles d'un moteur de localisation. Privilégiez une sélection explicite. Si ce champ est omis, la politique du service s'applique au lieu de désigner une configuration stable ; le service actuel peut exiger un ID ou sélectionner le plus ancien moteur de localisation activé auquel la clé donne accès.

Les fournisseurs directs utilisent un ID de fournisseur, un modèle et une consigne. Ce format historique ne constitue pas une recommandation et ne signifie pas que le modèle indiqué est toujours disponible :

json
{
  "provider": {
    "id": "openai",
    "model": "gpt-4o-mini",
    "prompt": "Translate the provided text from {source} to {target}."
  }
}

La consigne remplace {source} et {target} par les codes de langue. Ne comptez pas sur provider.baseUrl pour rediriger les requêtes run de lingo.dev@0.138.10. Son implémentation OpenAI transmet baseUrl, tandis que la dépendance du fournisseur, dont la version est fixée, lit baseURL ; cette valeur de configuration est donc ignorée. La dépendance prend en charge OPENAI_BASE_URL à la place ; vérifiez la destination prévue avant d'envoyer du contenu ou des identifiants d'authentification. L'implémentation Ollama ignore également provider.baseUrl et crée le fournisseur avec les valeurs par défaut. Son service doit être accessible depuis l'environnement d'exécution ; un environnement distant ne peut pas utiliser l'adresse localhost d'un ordinateur portable.

ServiceIdentifiant d'authentification
Lingo.devLINGO_API_KEY
OpenAIOPENAI_API_KEY
AnthropicANTHROPIC_API_KEY
GoogleGOOGLE_API_KEY
MistralMISTRAL_API_KEY
OpenRouterOPENROUTER_API_KEY
Ollama localAucune clé API de fournisseur dans la configuration locale.

LINGO_API_URL modifie la destination du service Lingo.dev ; il reste à vérifier sa compatibilité et à s'assurer qu'elle est digne de confiance. Ne stockez pas les identifiants d'authentification dans la configuration ni dans les journaux. Après avoir modifié le service ou la détection, reproduisez une petite exécution sur un premier fichier. Changer de modèle ou de consigne ne modifie pas les empreintes de la source ; si vous souhaitez mettre à jour le texte existant, une actualisation explicite est donc nécessaire.