lingo init
Créez une configuration de localisation en précisant les chemins des sources, des cibles et du catalogue.
lingo init écrit les paramètres de localisation dans .lingo/config.json. Utilisez cette commande pour définir la première langue source d’un projet, sa liste de langues cibles et ses motifs de fichiers. Les fichiers sources, les identifiants et l’association au moteur de localisation sont gérés séparément : l’initialisation ne crée ni ne traduit ces ressources.
lingo init --source en --targets de,fr --files 'locales/en.json,docs/en/**/*.md' --yesOuvrez le fichier généré et vérifiez qu’il sélectionne uniquement le contenu source souhaité. Créez ensuite ces fichiers si nécessaire, connectez-vous et exécutez link avant de lancer une traduction à distance.
Options #
| Option | Valeur par défaut ou effet |
|---|---|
--source <locale> | en si vous acceptez les valeurs par défaut. |
--targets <list> | Langues séparées par des virgules ; de,fr,es avec --yes. |
--files <list> | Motifs séparés par des virgules : locales/<source>.json avec --yes, par exemple locales/en.json. |
--messages-path <path> | Définit le catalogue React i18n.messagesPath ; valeur par défaut : locales. |
--types-path <path> | Définit la déclaration i18n.typesPath ; valeur par défaut : lingo.d.ts. |
--force | Remplace les paramètres de localisation existants. |
--no-agents-md | Ignore le bloc Lingo.dev dans AGENTS.md et CLAUDE.md. |
--yes, -y | Utilise les valeurs fournies ou les valeurs par défaut sans poser de questions. |
Sans --yes, les choix manquants vous sont demandés. Les listes sont découpées au niveau des virgules et des espaces ; pour ajouter un motif contenant un espace, modifiez .lingo/config.json. Les langues cibles en double et celle qui correspond exactement à la langue source sont supprimées. Si la liste des langues cibles est vide après ce traitement, elle est rejetée. Placez les motifs entre guillemets pour éviter que le shell ne les développe avant que la CLI ne les reçoive.
L'initialisation ajoute également un bloc Lingo.dev au fichier AGENTS.md du projet, qu'elle crée s'il n'existe pas, ainsi qu'à un fichier CLAUDE.md existant, sauf si ce dernier importe un AGENTS.md dans lequel le bloc est ajouté. Ce bloc indique aux agents de programmation d'exécuter npx @lingo.dev/cli agent-guide avant tout travail de localisation. Le texte en dehors des marqueurs du bloc est conservé ; lors d'une exécution ultérieure, seul le texte entre ces marqueurs est remplacé.
Réinitialisation d’un projet existant #
Sans forçage, la configuration de localisation existante est conservée et l’initialisation échoue plutôt que de l’écraser. En mode forcé, la commande reconstruit files[] à partir des motifs. Les options avancées des entrées, comme les exclusions, les formats explicites, les modèles de sortie et les options de contrôle des clés, sont perdues. Sauvegardez-les avant de forcer l’opération ou, pour un changement plus limité, modifiez la configuration existante.
Les autres sections racines, notamment l’association à l’organisation et au moteur de localisation, sont conservées. Les chemins de catalogue par défaut ne figurent pas dans la configuration enregistrée ; une exécution forcée qui rétablit les valeurs par défaut peut supprimer les valeurs personnalisées de i18n définies précédemment. Modifier les chemins de catalogue ne change pas automatiquement les motifs des fichiers de traduction.
Le guide du premier fichier prend le relais après la configuration et vous accompagne jusqu’au remplissage rétroactif initial et à la récupération des fichiers cibles. La section Configuration sert de référence pour les entrées de fichiers avancées.