Localisation de contenu statique

La CLI Lingo.dev traduit les fichiers statiques de votre dépôt — Markdown, MDX, Markdoc, JSON, YAML, sous-titres et plus encore — via un moteur de localisation configuré. Pointez-la vers votre contenu, lancez une seule commande et récupérez les fichiers traduits à côté des originaux.

Types de contenu pris en charge#

Le CLI détecte le format de chaque fichier à partir de son extension — aucun type de bucket n’est à configurer. La langue se trouve dans le chemin (content/en/x.md devient content/de/x.md), donc aucun placeholder [locale] n’est nécessaire.

Consultez la Référence des formats pour voir la liste complète des types de fichiers pris en charge.

Prérequis#

À chaque exécution, le contenu passe par un moteur de localisation — la configuration qui détermine le modèle de LLM, le glossaire, la voix de marque et les règles à appliquer. Créez-en un dans le tableau de bord Lingo.dev, puis configurez le CLI (Node 22+) :

npm install -g @lingo.dev/cli
lingo login
lingo init
lingo link

lingo init et lingo link créent .lingo/config.json, ce qui relie le CLI à votre organisation et à votre moteur. Validez ce fichier afin que tous les environnements partagent la même configuration.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "docs/en/getting-started.md" }]
}

En CI, ignorez lingo login et fournissez plutôt LINGO_API_KEY via une variable d’environnement. Vous pouvez en générer une depuis les clés API.

Sites de documentation#

La plupart des frameworks de documentation organisent le contenu traduit dans des répertoires par langue. Ajoutez un motif par fichier source (ou un glob) à files. Le CLI préserve le frontmatter, les blocs de code et la syntaxe des composants tout en traduisant les fichiers Markdown, MDX et Markdoc.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "docs/en/getting-started.md" },
    { "pattern": "docs/en/setup.mdx" }
  ]
}

Lancez une première traduction pour remplir toutes les langues cibles :

lingo push --backfill-missing

Lors des exécutions suivantes, lingo push ne traduit que ce qui a changé. Utilisez lingo pull pour récupérer des traductions produites ailleurs.

Ajustez le chemin source pour qu’il corresponde à la convention de répertoires de votre framework :

Données structurées#

Les fichiers JSON et YAML sont traduits automatiquement en fonction de leur extension. Utilisez les contrôles de clés pour empêcher la modification des valeurs non traduisibles (ID, URL, indicateurs de configuration).

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [
    { "pattern": "content/en.json" },
    { "pattern": "data/en.yaml" }
  ]
}

Le YAML générique ne nécessite pas de champ format. Seuls yaml-openapi, yaml-root-key et android requièrent un "format" explicite dans l’entrée du fichier.

Sous-titres#

Les fichiers de sous-titres SRT sont traduits en fonction de leur extension. Le CLI préserve toutes les données de minutage, les indices de repère et les balises de mise en forme — seul le contenu textuel est traduit.

{
  "orgId": "org_abc123",
  "engineId": "eng_abc123",
  "sourceLocale": "en",
  "targetLocales": ["es", "fr", "de", "ja"],
  "files": [{ "pattern": "subs/en/intro.srt" }]
}

Gérer des volumes de contenu importants#

Les dépôts de contenu statique peuvent contenir des milliers de fichiers. Le CLI gère cela efficacement :

Pour vérifier que les traductions sont à jour sans écrire de fichiers — pratique comme garde-fou en CI — exécutez lingo check.

Étapes suivantes#