Le CLI de Lingo.dev traduit les fichiers de ressources de votre application web — JSON, YAML, XLIFF, PO ou PHP — via un moteur de localisation configuré. Configurez l’i18n dans votre framework, pointez le CLI vers vos fichiers de traduction, puis lancez la commande.
Comment ça marche#
Chaque framework web s’appuie sur une bibliothèque i18n qui charge les traductions depuis des fichiers de ressources — JSON pour React, XLIFF pour Angular, PO pour Django, etc. Le CLI traduit directement ces fichiers pour que le framework récupère les traductions sans aucune modification du code.
Configurer l’i18n dans votre framework
Utilisez la bibliothèque i18n officielle de votre framework pour ajouter un routage adapté à la langue, une fonction de traduction et des fichiers de ressources dans la langue source. Chaque section ci-dessous renvoie vers le guide de configuration officiel du framework concerné.
Configurer le CLI
Créez un fichier i18n.json qui indique au CLI où se trouvent vos fichiers de traduction et quelles langues cibler. Le type de bucket doit correspondre au format de ressources de votre framework.
Lancer les traductions
Exécutez npx lingo.dev@latest run et le CLI traduit vos fichiers de ressources via le moteur de localisation — règles de glossaire, voix de marque et sélection du modèle s’appliquent automatiquement.
Prérequis#
Chaque exécution du CLI envoie le contenu via un moteur de localisation — la configuration qui détermine quel modèle LLM, glossaire, voix de marque et quelles instructions s’appliquent. Créez-en un dans le tableau de bord Lingo.dev et générez une clé API.
Configuration assistée par IA
Le i18n MCP peut générer automatiquement toute l’infrastructure i18n de votre framework. Connectez-le à Claude Code, Cursor ou GitHub Copilot, puis saisissez « Set up i18n » — l’agent suit une checklist en 13 étapes pour configurer le routage, les fichiers de traduction et un sélecteur de langue.
Frameworks JavaScript#
react-i18next charge les traductions depuis des fichiers JSON et fournit un hook useTranslation qui associe les clés aux chaînes traduites à l’exécution.
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de", "ja"]
},
"buckets": {
"json": {
"include": ["public/locales/[locale]/translation.json"]
}
}
}Frameworks côté serveur#
Laravel inclut une localisation intégrée qui charge les traductions depuis des fichiers PHP organisés par répertoire de langue.
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de", "ja"]
},
"buckets": {
"php": {
"include": ["lang/[locale]/messages.php"]
}
}
}Lancer les traductions#
Une fois i18n.json configuré, traduisez tous vos fichiers de ressources en une seule commande :
npx lingo.dev@latest runLe CLI lit vos fichiers de langue source, calcule ce qui a changé depuis la dernière exécution à l’aide du lockfile, traduit uniquement le delta, puis écrit le résultat dans les fichiers des langues cibles. Les traductions existantes sont conservées — le CLI ne complète que les chaînes manquantes ou mises à jour.
Ciblez une langue ou un bucket spécifique lorsque vous ne travaillez que sur un sous-ensemble :
npx lingo.dev@latest run --target-locale es
npx lingo.dev@latest run --bucket json