Skip to content

Référence de configuration ​

sourceLocale ​

Code BCP-47 de la langue source (par exemple "en-GB", "pt-BR" ou "ja"). Toute langue est valide. L'anglais apparaît dans les exemples car de nombreux projets commencent ainsi. Aucun fichier de traduction n'est généré pour ce paramètre régional — la chaîne clé elle-même est le texte source.

Doit correspondre à SOURCE_LOCALE exporté depuis votre fichier de configuration i18n au moment de l'exécution (src/i18n.ts / src/i18n.js).


targetLocales ​

Tableau de codes de langue BCP-47 vers lesquels traduire (par exemple, ["de", "fr", "es", "pt-BR"]).

targetLocales est la liste principale des paramètres régionaux pour la traduction de l'interface utilisateur et la liste par défaut des blocs de documentation. Utilisez generate-ui-languages pour générer le manifeste ui-languages.json à partir de sourceLocale + targetLocales.


uiLanguage (facultatif) ​

Code BCP-47 pour la langue de l'interface utilisateur de l'outil (aide CLI, journaux/résumés et tableau de bord de traduction). Il est indépendant de sourceLocale / targetLocales et est remplacé par l'indicateur -L / --ui-lang et la variable d'environnement AI_I18N_LANG. Les valeurs inconnues sont rétrogradées en douceur vers les paramètres régionaux source (en-GB) — il n'y a pas de validation stricte. Voir Langue de l'interface utilisateur de l'outil.


languagesManifestPath (facultatif) ​

Chaîne optionnelle au niveau racine. Le sélecteur de langue de la documentation lit ce chemin. S'il est omis, il prend par défaut le manifeste du premier bloc d'interface utilisateur : le languagesManifestPath de ce bloc, ou {flatOutputDir}/ui-languages.json. Chaque bloc d'interface utilisateur peut définir son propre languagesManifestPath ; le bloc 0 utilise ce chemin racine lorsque le bloc omet le sien.

Utilisez cette option lorsque :

  • Le manifeste doit se trouver en dehors de ui.flatOutputDir (par exemple, à côté des assistants d'application sous src/i18n/).
  • Vous souhaitez que le post-traitement du sélecteur de langue (languageListBlock) construise les étiquettes de locale à partir du manifeste du projet plutôt que du seul catalogue maître fourni.

includeUiLanguageEnglishNames ne lit pas ce fichier — il utilise le catalogue maître fourni (voir ui.uiExtractor ci-dessous).

Hérité : uiLanguagesPath de niveau racine est toujours accepté lors du chargement d'un fichier de configuration et est automatiquement réécrit en languagesManifestPath.


concurrency (facultatif) ​

Nombre maximal de locales cibles traduites simultanément (translate-ui, translate-docs, translate-svg et les étapes correspondantes dans sync). Si omis, la CLI utilise 4 pour la traduction de l'interface utilisateur et 3 pour la traduction de la documentation (valeurs par défaut intégrées). Peut être remplacé par exécution avec -j / --concurrency.


batchConcurrency (facultatif) ​

translate-docs, translate-svg et translate-json (ainsi que les étapes correspondantes dans sync) : nombre maximal de requêtes LLM par lot en parallèle par fichier (chaque lot peut contenir de nombreux segments). La valeur par défaut est 4 si omise. Ne s'applique pas à translate-ui — utilisez uiBatchConcurrency à la place. Outrepassez avec -b / --batch-concurrency.


uiBatchConcurrency (facultatif) ​

translate-ui, sync-ui et l'étape UI de sync : nombre maximal de requêtes LLM par lot en parallèle au sein d'une seule locale (blocs de chaînes de caractères de 50, puis groupes pluriels). La valeur par défaut est 2 si omise. Indépendant de concurrency (locales cibles parallèles) et batchConcurrency (docs/JSON/SVG). Pas de drapeau CLI ; définissez-le dans la configuration ou passez uiBatchConcurrency à runTranslateUI programmatique.

Exemple :

json
{
  "uiBatchConcurrency": 2
}

Avec la concurrence de locale par défaut de 4, cela représente jusqu'à 8 appels d'API UI en cours. Augmentez cette valeur lors de la traduction d'une grande locale (-l de) ; maintenez-la basse si le fournisseur applique des limites de débit.


fileConcurrency (facultatif) ​

Nombre maximal de fichiers traités simultanément dans une même langue pendant translate-docs et sync. Lorsqu’il est défini à une valeur supérieure à 1, les fichiers de la même langue sont traités en parallèle à l’aide d’un sémaphore pour contrôler l’utilisation de la mémoire. Valeur par défaut : 1 (traitement séquentiel) si omis. Des valeurs plus élevées peuvent améliorer significativement le débit pour les opérations liées aux E/S, en particulier lorsque tous les segments sont déjà mis en cache (aucun appel API nécessaire).

Exemple :

json
{
  "fileConcurrency": 4
}

Cas d’usage : Définissez cette valeur à 2-4 lors de l’exécution de sync --force-update avec 100 % de succès de cache pour réduire le temps total de traitement. L’amélioration est particulièrement notable avec de nombreux petits fichiers.


batchSize / maxBatchChars (facultatif) ​

Traitement par lots des segments pour translate-docs, translate-svg et translate-json : nombre de segments par requête API et plafond de caractères. Valeurs par défaut : 20 segments, 4096 caractères (si omises).


requestTimeout / requestTimeoutMs (facultatif) ​

Délai d'attente maximal pour chaque requête LLM, pour chaque fournisseur. requestTimeout correspond à des secondes entières ; requestTimeoutMs correspond à des millisecondes. Par défaut : 120 secondes si les deux sont omis. Définissez un seul des deux. Un fournisseur qui définit l'un ou l'autre champ utilise cette valeur à la place, pour ce fournisseur uniquement.


provider et providers ​

provider (niveau supérieur, facultatif) sélectionne la clé du fournisseur actif parmi providers. Il est facultatif lorsqu'un seul fournisseur est configuré ; requis lorsque plus d'un est configuré.

providers (niveau supérieur) mappe une clé de fournisseur à son bloc. Les clés intégrées (voir le tableau des préréglages ci-dessous) n'ont besoin que de translationModels ; toute autre clé définit un point de terminaison personnalisé compatible OpenAI et nécessite baseUrl (plus apiKeyEnv sauf si le point de terminaison n'a pas besoin de clé).

Chaque bloc providers.<name> accepte :

  • translationModels Liste ordonnée préférée des ID de modèle (ID amont bruts, sans préfixe provider/ ; les ID OpenRouter conservent leur forme native vendor/model). Le premier est essayé en premier ; les entrées suivantes sont des solutions de repli en cas d'erreur. C'est la chaîne par défaut globale pour chaque pipeline lorsqu'aucun niveau plus spécifique ne s'applique.
  • uiModels (facultatif) Liste de modèles ordonnée, réservée à l'interface utilisateur, pour translate-ui, la génération au pluriel (Étape 0 et Passe B) et proofread-ui. Essayée après toute entrée localeModels correspondante pour la locale cible, avant translationModels.
  • localeModels (facultatif) Remplacements par locale pour tous les pipelines de traduction. Tableau d'objets { "locale": "<BCP-47>", "models": ["…"] }. Les balises de locale sont mises en correspondance sans tenir compte de la casse (pt-br = pt-BR). La liste de chaque locale est d'abord essayée pour cette locale uniquement, puis les niveaux spécifiques au pipeline (uiModels pour l'interface utilisateur) et translationModels. Les clés de locale normalisées en double sont rejetées lors du chargement de la configuration.
  • baseUrl URL de base compatible OpenAI. Remplace l'URL de base prédéfinie ; requise pour un fournisseur non prédéfini.
  • apiKeyEnv Variable d'environnement contenant la clé API. Remplace la variable d'environnement prédéfinie.
  • headers En-têtes HTTP supplémentaires envoyés avec chaque requête à ce fournisseur.
  • maxTokens Nombre maximal de jetons de complétion par requête. Par défaut : 8192.
  • temperature Température d'échantillonnage. Par défaut : 0.2.
  • requestTimeout Délai d'attente maximal en secondes pour chaque requête adressée à ce fournisseur. Remplace le requestTimeout / requestTimeoutMs de niveau supérieur. Si ni ce fournisseur ni la configuration de niveau supérieur ne définissent de délai d'attente, la valeur par défaut est de 120 secondes. Définissez un seul des requestTimeout et requestTimeoutMs sur le même objet.
  • requestTimeoutMs Délai d'attente maximal en millisecondes pour chaque requête adressée à ce fournisseur. Remplace le requestTimeout / requestTimeoutMs de niveau supérieur. Si ni ce fournisseur ni la configuration de niveau supérieur ne définissent de délai d'attente, la valeur par défaut est 120000 (120 secondes). Définissez un seul des requestTimeout et requestTimeoutMs sur le même objet.
  • pricing (facultatif) Coût en USD par million de jetons pour l'ensemble du fournisseur : { "inputPerMTokens": 0.15, "outputPerMTokens": 0.6 }. Lorsqu'un appel facturé n'a pas de usage.cost signalé par le fournisseur (la plupart des fournisseurs, à l'exception d'OpenRouter et de Cheaper Inference), ce taux est appliqué aux jetons d'entrée et de sortie de cet appel. Le montant est inclus dans le résumé de la traduction et stocké dans la ligne api_calls.

La source du coût est résolue dans cet ordre :

  1. une entrée modelPricing correspondante (remplace cette valeur par défaut du fournisseur) ;
  2. un coût signalé par le fournisseur (jamais remplacé) ;
  3. ce taux pricing ;
  4. le prix catalogue models.dev pour cet ID de modèle (USD par 1 million de jetons d'entrée et de sortie).

Les lignes qui ont été stockées sans coût peuvent toujours être estimées ultérieurement par usage et Utilisation et coûts. Si aucune de ces sources ne s'applique, le coût reste inconnu (—), jamais $0.00.

  • modelPricing (facultatif) Coût par 1 million de jetons en USD par modèle : { "<model-id>": { "inputPerMTokens": 2.5, "outputPerMTokens": 10 } }. Remplace pricing pour cet ID de modèle. Appliqué au moment de l'appel lorsque le fournisseur a omis usage.cost, et stocké avec l'appel.
  • zeroDataRetention (facultatif, providers.cheaperinference uniquement) Lorsque true, les requêtes de chat envoient "zdr": true et list-models, check-models, et suggest-models chargent GET /v1/models?zdr=true. Omettre signifie désactivé. Voir Rétention de données nulle.

Préréglages de fournisseurs intégrés (clé — URL de base — variable d'environnement de la clé API) :

FournisseurURL de baseVariable d'environnement de la clé API
alibabahttps://dashscope-intl.aliyuncs.com/compatible-mode/v1ALIBABA_API_KEY
anthropichttps://api.anthropic.com/v1ANTHROPIC_API_KEY
apikeyfanhttps://api.apikey.fan/v1APIKEYFAN_API_KEY
cerebrashttps://api.cerebras.ai/v1CEREBRAS_API_KEY
cheaperinferencehttps://api.cheaperinference.com/v1CHEAPERINFERENCE_API_KEY
deepseekhttps://api.deepseek.comDEEPSEEK_API_KEY
geminihttps://generativelanguage.googleapis.com/v1beta/openaiGOOGLE_API_KEY
groqhttps://api.groq.com/openai/v1GROQ_API_KEY
mistralhttps://api.mistral.ai/v1MISTRAL_API_KEY
nvidiahttps://integrate.api.nvidia.com/v1NVIDIA_API_KEY
ollamahttp://localhost:11434/v1(aucun)
openaihttps://api.openai.com/v1OPENAI_API_KEY
openrouterhttps://openrouter.ai/api/v1OPENROUTER_API_KEY
xaihttps://api.x.ai/v1XAI_API_KEY

Le préréglage apifun a été renommé en apikeyfan. Mettez à jour les clés provider et providers dans les configurations existantes ; APIFUN_API_KEY reste un alias de APIKEYFAN_API_KEY.

Un bloc openrouter de niveau supérieur hérité (avec baseUrl, translationModels, defaultModel, fallbackModel, maxTokens, temperature, requestTimeout, requestTimeoutMs) est toujours accepté et est automatiquement migré vers providers.openrouter (avec provider: "openrouter") au chargement ; defaultModel / fallbackModel se replient dans translationModels.

Pour un exemple exécutable qui configure plusieurs fournisseurs dans une seule configuration et bascule entre eux avec -P, voir examples/multi-provider (openai, anthropic, openrouter et deepseek sur le même document).

Pourquoi utiliser plusieurs modèles : Les différents fournisseurs et modèles ont des coûts variables et offrent des niveaux de qualité différents selon les langues et les locales. Configurez translationModels en tant que chaîne de secours ordonnée afin que la CLI puisse essayer le modèle suivant si une requête échoue. Le guide pour créer cette liste est AI Models.

Considérez la liste ci-dessous comme une base de référence. Remplacez-la en vous basant sur le classement de référence de AI Models. Si la traduction pour une locale spécifique reste de mauvaise qualité, ajoutez une entrée localeModels pour cette langue ou ce script, ou ajoutez d'autres ID depuis le catalogue du fournisseur.

Ces identifiants de modèle sont ce que ai-i18n-tools init -P openrouter écrit. Les autres préréglages obtiennent des identifiants de modèle natifs de init -P <provider> — voir Fournisseurs intégrés.

Cette liste a été testée pour une couverture étendue des paramètres régionaux dans un vaste projet de documentation comportant 36 paramètres régionaux cibles ; elle sert de valeur par défaut pratique, mais n'est pas garantie pour fonctionner correctement dans tous les paramètres régionaux.

Exemple translationModels (liste OpenRouter de ai-i18n-tools init -P openrouter) :

Liste des translationModels d'OpenRouter
json
"translationModels": [
  "google/gemini-2.5-flash",
  "meta-llama/llama-3.3-70b-instruct",
  "openai/gpt-4o-mini",
  "google/gemma-4-26b-a4b-it",
  "~anthropic/claude-haiku-latest",
  "z-ai/glm-5.2",
  "google/gemini-3.5-flash",
  "~anthropic/claude-sonnet-latest"
  // … add more fallback models as needed
]

uiModels recommandé : Les chaînes d'interface utilisateur sont courtes mais très visibles — un modèle premium améliore souvent le ton, les pluriels et la cohérence. Le uiModels facultatif est essayé après toute entrée localeModels correspondante et avant translationModels (voir la liste des champs ci-dessus). Exemple :

Modèles d'interface utilisateur recommandés pour la traduction d'interface utilisateur
json
"uiModels": [
  "~anthropic/claude-sonnet-latest",
  "z-ai/glm-5.2"
]

localeModels recommandé pour les langues asiatiques : Les paramètres régionaux japonais, coréens et chinois bénéficient souvent de modèles adaptés à ces écritures. Ajoutez des remplacements par paramètre régional qui sont essayés en premier (avant uiModels / translationModels) lorsque le paramètre régional cible correspond :

localeModels recommandés pour ja, ko, zh-Hans, zh-Hant
json
"localeModels": [
  { "locale": "ja",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "ko",      "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hans", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] },
  { "locale": "zh-Hant", "models": [ "z-ai/glm-5.2", "minimax/minimax-m2.7" ] }
]

Définissez la variable d'environnement de la clé API du fournisseur actif (voir le tableau des préréglages) dans votre environnement ou votre fichier .env.

Avant de modifier les listes de modèles, exécutez ai-i18n-tools check-models. Pour chaque fournisseur, il vérifie chaque ID de modèle configuré (translationModels, uiModels et toutes les entrées localeModels) par rapport à la liste de modèles en direct de ce fournisseur (GET /models), signale les ID manquants ou passés expiration_date, liste les modèles valides et quitte avec un code d'erreur si un ID configuré est invalide. Lorsque le fournisseur renvoie des prix (par exemple OpenRouter), il affiche également les prix d'entrée/sortie estimés (USD par million de jetons).

Pour comparer les modèles configurés sur un travail de traduction réel, exécutez ai-i18n-tools bench-models. Il évalue chaque ID de modèle unique de translationModels, uiModels et localeModels en traduisant un échantillon à travers chacun isolément (en parallèle, limité par concurrency) et imprime les jetons d'entrée/sortie par modèle, le temps réel et le coût en USD, afin que vous puissiez peser la vitesse par rapport au prix avant de vous décider sur les listes de modèles.


features ​

ChampPipelineDescription
translateUIStrings1Extrait t("…") / i18n.t("…") dans strings.json, puis traduit les entrées et écrit un JSON plat par locale (l'extraction s'exécute automatiquement ; utilisez extract autonome pour actualiser le catalogue uniquement).
translateDocs2Traduire les pages .md / .mdx / .astro / .html / .htm ; JSON du shell Docusaurus lorsque docs[].docusaurusCatalogDir est défini ; _meta / dictionnaire Nextra lorsqu'il est configuré ; thème VitePress lorsque docsOutput.vitepressThemeCatalog est défini ; meta.json / catalogue d'interface utilisateur Fumadocs lorsque docsOutput.style est "fumadocs".
translateJson3JSON arbitraire imbriqué sous json[] (translate-json).
translateSVG—Traduire les fichiers .svg (nécessite le bloc svg au niveau racine).

Chaque indicateur est par défaut à true lorsque la clé est omise. Le comportement est le suivant :

  • Un true omis sans rien à traduire est ignoré : aucun bloc d'interface utilisateur n'a sourceRoots, aucun bloc de documentation n'a contentPaths ou docusaurusCatalogDir, json[] n'a pas de contentPaths, ou svg n'est pas défini.
  • Écrire l'indicateur comme true lorsque ce pipeline n'a pas de travail est une erreur de configuration.
  • Écrire false désactive ce pipeline pour sync même si des sources existent.
  • --no-ui, --no-docs, --no-json et --no-svg ignorent l'étape pour une seule exécution.

Traduisez les fichiers SVG avec translate-svg lorsque features.translateSVG est vrai et qu'un bloc svg de niveau racine est configuré. La commande sync exécute cette étape lorsque l'option est activée et que svg est défini (sauf si --no-svg).


ui ​

Un objet catalogue, ou un tableau de blocs de catalogue (le même principe que docs[]). Un objet unique est accepté au chargement et encapsulé dans un tableau à un seul élément ; le fichier sur le disque n'est pas réécrit. Après l'analyse, config.ui est toujours un tableau.

extract, translate-ui, sync-ui, la phase d'interface utilisateur de sync, proofread-ui, export-ui-xliff, generate-ui-languages et purge-locale parcourent chaque bloc possédant sourceRoots. Passez --ui-block avec un index commençant à zéro, le description du bloc, ou son chemin stringsJson pour exécuter un seul bloc. status et statistics listent chaque bloc ayant des sources ou un catalogue existant. Le tableau de bord de traduction liste chacun de ces catalogues et affiche un sélecteur lorsqu'il y en a plus d'un.

Les chemins résolus stringsJson, flatOutputDir et de manifeste doivent être uniques pour tous les blocs. Les valeurs description doivent être uniques lorsqu'elles sont définies, car --ui-block les fait correspondre exactement.

  • description Note optionnelle pour les personnes lisant la configuration (non envoyée au modèle). Affichée en tant que ui[i] — description dans les en-têtes de commande, status, statistics et le tableau de bord.
  • sourceRoots Répertoires ou motifs glob (relatifs au cwd) analysés pour les appels t("…"). Prend en charge les motifs comme src/ ou ["src/**/*.ts"]. Un bloc avec une liste vide est ignoré à moins que --ui-block ne le nomme, ce qui constitue une erreur.
  • stringsJson Chemin vers le fichier de catalogue principal de ce bloc. Mis à jour par extract.
  • flatOutputDir Répertoire où les fichiers JSON par locale de ce bloc sont écrits (de.json, etc.).
  • flatOutput Lorsque true (par défaut), translate-ui écrit un fichier JSON plat par locale. Définissez false pour n'émettre que gettext ou resx. Un bloc avec flatOutput: false doit définir gettext ou resx.
  • resx Sortie .NET .resx facultative. outputDir (par défaut Resources) et baseName (par défaut SharedResource) écrivent {baseName}.resx plus {baseName}.{culture}.resx. writeNeutral (vrai par défaut) place le texte source dans le fichier neutre afin que ResourceManager puisse se rabattre. localeFormat est bcp47 (par défaut, pt-BR) ou posix (pt_BR). ingestExistingResx (vrai par défaut) lit les satellites pendant extract. neutralFile mappe les clés nommées héritées telles que LoginButton via la valeur neutre. Les clés de contexte utilisent U+2404. Les formes plurielles sont des entrées distinctes nommées {singular}[{form}]. Un bloc avec flatOutput: false doit définir gettext ou resx.
  • gettext Sortie GNU gettext facultative pour ce bloc. outputDir (par défaut ./locales) reçoit <locale>/LC_MESSAGES/<domain>.po et, lorsque compileMo est vrai (par défaut), le .mo correspondant. domain est par défaut messages. potPath est le catalogue de modèles. ingestExistingPo (par défaut true) remplit les emplacements strings.json vides à partir des valeurs msgstr non floues pendant extract et ne remplace pas une traduction non vide ou éditée par l'utilisateur. localeFormat est posix (par défaut, pt_BR) ou bcp47 (pt-BR). Les lignes contextuelles utilisent le séparateur gettext \u0004. La même chaîne de langue source dans deux contextes ne partage pas d'identifiant de catalogue.
  • targetLocales Liste de locales facultative pour ce bloc. Lorsqu'elle est omise ou vide, le bloc utilise la racine targetLocales.
  • languagesManifestPath Chemin facultatif où extract et generate-ui-languages écrivent le ui-languages.json de ce bloc. Lorsqu'il est omis, le bloc 0 utilise la racine languagesManifestPath (qui par défaut est le {flatOutputDir}/ui-languages.json de ce bloc). Les blocs ultérieurs utilisent {flatOutputDir}/ui-languages.json par défaut.
  • uiGlossary Lorsque true (par défaut), le strings.json de ce bloc est une source d'indices de glossaire pour translate-docs, translate-json et translate-svg. translate-ui, proofread-ui et le linting de source n'utilisent que glossary.userGlossary. Définissez false pour exclure un catalogue de ces indices (par exemple, un catalogue de chaînes CLI qui ne devrait pas orienter la documentation).
  • uiExtractor.funcNames (ou reactExtractor.funcNames hérité) Noms de fonctions supplémentaires à analyser (par défaut : ["t", "i18n.t"]).
  • uiExtractor.extensions (ou reactExtractor.extensions hérité) Extensions de fichier à inclure (par défaut : [".js", ".jsx", ".ts", ".tsx"]). Ajoutez .astro pour le frontmatter Astro et les expressions de modèle.
  • uiExtractor.includePackageDescription (ou reactExtractor.includePackageDescription hérité) Lorsque true (par défaut), extract inclut également package.json description comme chaîne d'interface utilisateur lorsqu'il est présent. Définissez false sur des blocs supplémentaires afin que la même description ne soit pas extraite dans chaque catalogue.
  • uiExtractor.packageJsonPath (ou reactExtractor.packageJsonPath hérité) Chemin personnalisé vers le fichier package.json utilisé pour cette extraction de description facultative.
  • uiExtractor.includeUiLanguageEnglishNames (ou reactExtractor.includeUiLanguageEnglishNames hérité)

Lorsque true (par défaut false), extract ajoute également chaque englishName du catalogue maître ui-languages fourni (construit à partir de sourceLocale + le targetLocales effectif du bloc) à strings.json s'il n'est pas déjà présent à partir de l'analyse source (mêmes clés de hachage). Ne lit pas languagesManifestPath.

  • uiExtractor.placeholderStyledefault (mustache, champs de format Python et printf) ou dotnet ({0}, {0,-10}, {0:format} uniquement). Dans le style dotnet, un signe de pourcentage est un texte littéral et les accolades doubles sont des accolades littérales. Le modèle ui-dotnet définit dotnet.
  • uiExtractor.exclude Motifs minimatch, relatifs à la racine du projet, ignorés après l'analyse. bin, obj, .vs, TestResults et packages sont déjà ignorés par nom de répertoire. Les modèles ui-dotnet et ui-dotnet-resx excluent **/Tests/**, **/*.Tests/** et **/TrExtension.cs.

glossary.uiGlossary et glossary.uiGlossaryFromStringsJson ne sont plus acceptés. Le chargement de la configuration échoue et l'erreur explique le remplacement : supprimez la clé. Les indices proviennent désormais de l'option uiGlossary de chaque bloc (par défaut true).


cacheDir ​

  • cacheDir Répertoire de cache SQLite (partagé par tous les blocs docs). Par défaut .translation-cache. Réutilisation entre les exécutions. Si vous migrez depuis un cache de traduction de documentation personnalisé, archivez-le ou supprimez-le — cacheDir crée sa propre base de données SQLite et n'est pas compatible avec d'autres schémas. suggest-models stocke également les agrégats de benchmark dans <cacheDir>/benchmark-scores.json. Ce fichier est un cache, comme le reste du répertoire, et ne fait pas partie du package publié.

Bonnes pratiques pour les exclusions git : ​

  • Excluez le contenu du dossier de cache de traduction (par exemple, en utilisant .gitignore ou .git/info/exclude) pour éviter de commettre des artefacts de cache temporaires.
  • Conservez cache.db (ne le supprimez pas systématiquement), car la conservation du cache SQLite empêche la retraduction des segments inchangés. Cela permet d'économiser des coûts d'exécution et d'API lors de la mise à jour ou de la modification de logiciels utilisant ai-i18n-tools.
  • Excluez les fichiers d'environnement et les fichiers temporaires afin que les secrets et les sauvegardes ne soient pas commis.

Exemple :

init écrit ce bloc pour le cacheDir par défaut. Lorsque cacheDir est différent, les deux lignes de cache utilisent ce répertoire, par exemple .i18n-cache/* et !.i18n-cache/cache.db.

gitignore
# Cache
.translation-cache/*
!.translation-cache/cache.db
benchmark-scores.json

# Environment
.env
.env.local
.env.*.local

# Temporary files
*.tmp
*.backup.*

docs ​

Tableau de blocs de pipeline de documentation. translate-docs et la phase de documentation de sync traitent chaque bloc dans l'ordre. Les clés héritées sont toujours acceptées au moment du chargement et réécrites lorsque le fichier de configuration est inscriptible ; préférez les noms actuels dans les nouvelles configurations.

Clé héritéeClé/comportement actuel
documentationsdocs
markdownOutputdocs[].docsOutput
jsonSourcedocs[].docusaurusCatalogDir
openrouter de niveau supérieurproviders.openrouter + provider: "openrouter"
features.translateMarkdownfeatures.translateDocs
features.translateJSONsupprimé (utiliser docs[].docusaurusCatalogDir ou json[])
features.extractUIStringssupprimé (extract s'exécute avant la traduction de l'interface utilisateur)
glossary.uiGlossary et glossary.uiGlossaryFromStringsJsonsupprimés ; le chargement de la configuration échoue. Utilisez ui[].uiGlossary (booléen, valeur par défaut true)
ui.reactExtractorui.uiExtractor (l'alias est toujours accepté)
svg.svgExtractor.forceLowercasesvg.forceLowercase

Sources de contenu

  • description Note facultative lisible par l'humain pour ce bloc (non utilisée pour la traduction). Préfixe dans le titre translate-docs 🌐 lorsqu'elle est définie ; également affichée dans les en-têtes de section status.
  • contentPaths Corps de pages Markdown/MDX et modèles .astro à traduire (translate-docs analyse ceux-ci pour .md, .mdx et .astro). Prend en charge les chemins de répertoire ou les motifs glob (par exemple "docs/**/*.md", "guides/*.mdx", "src/pages/index.astro"). C'est là que provient la prose documentaire localisée.
  • sourceFiles Alias facultatif fusionné dans contentPaths au chargement.
  • targetLocales Sous-ensemble facultatif de paramètres régionaux pour ce bloc uniquement (sinon utilise targetLocales au niveau racine). Les paramètres régionaux de documentation effectifs sont l'union entre tous les blocs.
  • docusaurusCatalogDir Facultatif. Répertoire source des catalogues d'étiquettes JSON Docusaurus pour ce bloc (par exemple, "i18n/en" de docusaurus write-translations). Les corps de page proviennent toujours de contentPaths ; docusaurusCatalogDir ne fournit que le JSON de l'interface/shell, pas le MDX.
  • nextraMetaGlob Glob(s) facultatif(s) pour _meta.ts / _meta.tsx / _meta.js Nextra sous docsRoot. Lorsque docsOutput.style est "nextra" et que ceci est omis, tous les fichiers _meta sous docsRoot sont collectés automatiquement.
  • nextraMetaTranslatableKeys Noms de propriétés facultatifs dont les valeurs de chaîne sont traduites dans les objets _meta Nextra (par défaut : title, display, breadcrumb).
  • nextraDictionaryPath Module de dictionnaire de thème Nextra anglais facultatif (par exemple, "app/_dictionaries/en.ts"). Traduit en {dir}/{locale}.ts pendant translate-docs.
  • nextraDictionaryOutputTemplate Modèle de sortie facultatif pour les modules de dictionnaire de locale (par défaut : {dir}/{locale}.ts par rapport au répertoire du dictionnaire).

docsOutput ​

Disposition de la sortie pour ce bloc.

  • outputDir Répertoire racine pour la sortie traduite de ce bloc.
  • docsOutput.style"nested" (par défaut), "flat", "doc-system", ou les alias "docusaurus" / "astro-starlight" / "vitepress" / "nextra".
  • docsOutput.localeSubpath Segment de chemin entre {locale}/ et {relativeToDocsRoot} pour doc-system (obligatoire lors de l'utilisation directe de style: "doc-system" ; prédéfini lors de l'utilisation d'un alias). Utilisez "" pour les dossiers de locale de style Starlight.
  • docsOutput.docsRoot Racine des documents source pour la mise en page Docusaurus (par exemple, "docs"). Par défaut "docs" si omis.
  • docsOutput.pathTemplate Chemin de sortie Markdown personnalisé. Espaces réservés : "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{docsRoot}", "{relativeToDocsRoot}".
  • docsOutput.jsonPathTemplate Chemin de sortie JSON personnalisé pour les fichiers d'étiquettes. Prend en charge les mêmes espaces réservés que pathTemplate.
  • docsOutput.localePathLowercase Lorsque true, les mises en page de sortie intégrées (nested, flat, doc-system sans pathTemplate) utilisent des segments de paramètres régionaux en minuscules dans les chemins. Par défaut false ; astro-starlight et doc-system avec localeSubpath vide par défaut à true au chargement de la configuration.
  • docsOutput.flatPreserveRelativeDir Lorsque docsOutput.style = "flat", conserve les sous-répertoires source afin que les fichiers avec le même nom de base n'entrent pas en collision. Par défaut false.
  • docsOutput.rewriteRelativeLinks Réécrire les liens relatifs après la traduction (activé automatiquement lorsque docsOutput.style = "flat" et sans pathTemplate personnalisé).
  • docsOutput.linkRewriteDocsRoot Racine du dépôt utilisée lors du calcul des préfixes de réécriture de liens plats. Laissez généralement ceci tel quel (".") sauf si vos documents traduits se trouvent sous une autre racine de projet.
  • docsOutput.rewriteVitepressLinks Lorsque true, exécuter le normaliseur de liens VitePress après la traduction. Activé par défaut lorsque docsOutput.style est "vitepress". À utiliser avec toute mise en page doc-system où les dossiers de locale se trouvent à côté des fichiers de locale source sous docsRoot. La langue source est sourceLocale et peut être n'importe quelle langue. Réécrit les chemins docs/guide/… de style README vers les routes du site (/guide/…) et les liens ../guide/… relatifs à la locale. Pour les liens vers des fichiers du dépôt en dehors de l'arborescence VitePress (LICENSE, examples/), utilisez des URL complètes dans les fichiers de locale source — voir Intégration VitePress — README comme page d'accueil des documents.
  • docsOutput.rewriteNextraLinks Lorsque true, exécuter le normaliseur de liens Nextra après la traduction. Activé par défaut lorsque docsOutput.style est "nextra". Réécrit les chemins content/en/… et .mdx relatifs vers des routes de site neutres en locale (/guide/…) pour Next.js i18n. Voir Intégration Nextra — Conventions de liens.
  • docsOutput.fumadocsParser"dot" (par défaut) ou "dir". Dot écrit stem.{locale}.mdx à côté des fichiers de locale source ; dir écrit des dossiers de locale comme Nextra. La langue source est sourceLocale et peut être n'importe quelle langue. Voir Intégration Fumadocs — Disposition de la page.
  • docsOutput.rewriteFumadocsLinks Lorsque true, exécuter le normaliseur de liens Fumadocs après la traduction. Activé par défaut lorsque docsOutput.style est "fumadocs". Réécrit les chemins de contenu et les liens .mdx relatifs vers les routes /docs/….
  • docsOutput.fumadocsUiCatalog Facultatif. Amorçage du catalogue de remplacement de l'interface utilisateur Fumadocs + traduction à l'intérieur de translate-docs. Champs : sourcePath (par exemple lib/layout.shared.ts), catalogPath (JSON anglais généré), outputPathTemplate facultatif (par défaut : ui.{locale}.json à côté de catalogPath).
  • docs[].fumadocsMetaGlob Glob(s) facultatif(s) pour la collection meta.json lorsque docsOutput.style est "fumadocs". Par défaut : meta.json récursif sous docsOutput.docsRoot.
  • docs[].fumadocsMetaTranslatableKeys Noms des propriétés dont les valeurs de chaîne sont traduites dans le meta.json Fumadocs (par défaut : title, description).
  • docsOutput.localizedAssets Renommage facultatif des URL d'images et d'icônes dans le HTML traduit lorsqu'un fichier de langue existe. Champs : include (par défaut img/**), pattern (par défaut {stem}-{locale}{ext}), onlyIfExists (par défaut true), assetRoot (répertoire utilisé pour tester les URL relatives à la racine ; par défaut, le répertoire du fichier HTML). Placeholders : {stem}, {ext}, {basename}, {locale}, {llocale}, {LOCALE}. Le url() CSS n'est pas réécrit. Voir Pages HTML.
  • docsOutput.html Liste de langues et hreflang facultatifs pour les documents HTML. Les commentaires par défaut sont <!-- ai-i18n:lang-list --> … <!-- /ai-i18n:lang-list --> et <!-- ai-i18n:hreflang --> … <!-- /ai-i18n:hreflang -->. languageList.format est links ou select. languageList.label est local, english ou both. hreflang.siteUrl préfixe les liens alternatifs ; lorsqu'il est omis, les liens sont relatifs et un avertissement est consigné. hreflang.xDefault a pour valeur par défaut sourceLocale. hreflang.stripIndexHtml transforme index.html en URL de répertoire. Pour le HTML, docsRoot est supprimé avant l'ajout du dossier de langue (site/index.html → site/{locale}/index.html lorsque docsRoot est site). Voir Pages HTML.
  • docsOutput.vitepressThemeCatalog Facultatif. Initialisation et traduction du catalogue de thème, navigation et barre latérale VitePress dans translate-docs. Champs : configPath (configuration VitePress avec les chaînes du thème), catalogPath (JSON imbriqué anglais généré), outputPathTemplate facultatif (par défaut : theme.{locale}.json à côté de catalogPath).

Post-traitement

  • docsOutput.postProcessing Transformations facultatives sur le corps Markdown traduit (les clés YAML et les valeurs de métadonnées non-prose sont conservées). S'exécute après le réassemblage des segments et la réécriture des liens (plat ou VitePress), et avant addFrontmatter.
  • docsOutput.postProcessing.regexAdjustments Liste ordonnée de { "description"?, "search", "replace" }. search est un motif d'expression régulière (une chaîne simple utilise l'indicateur g, ou /pattern/flags). replace prend en charge des espaces réservés tels que ${translatedLocale}, ${sourceLocale}, ${sourceFullPath}, ${translatedFullPath}, ${sourceFilename}, ${translatedFilename}, ${sourceBasedir}, ${translatedBasedir}.
  • docsOutput.postProcessing.languageListBlock{ "start", "end", "separator", "label"? } — régénère une ligne de liens "lire dans d'autres langues" délimitée dans le Markdown source et traduit. Nécessite languagesManifestPath (ou un manifeste à ui.flatOutputDir/ui-languages.json) pour les étiquettes endonymes lorsque label: "local".

Comportement et métadonnées

  • translateFrontmatterFields Même niveau que docsOutput (par bloc docs[]). Par défaut true : traduire le texte YAML destiné à l'utilisateur pour Starlight/Docusaurus (title, description, sidebar.label, sidebar_label, keywords, hero.title, hero.tagline, hero.image.alt, hero.actions[].text, pagination_label, étiquettes prev/next). Définissez false pour conserver l'intégralité du bloc de métadonnées inchangé ; passez un tableau de chaînes pour le restreindre à des chemins de points spécifiques.
  • segmentSplitting Même niveau que docsOutput (par bloc docs[]). Segments optionnels plus fins pour l'extraction translate-docs : { "enabled", "maxCharsPerSegment"?, "splitPipeTables"?, "splitDenseParagraphs"?, "maxLinesPerParagraphChunk"?, "splitLongLists"?, "maxListItemsPerChunk"?, "qualityRetrySplit"?, "maxQualityRetrySplitDepth"? }. Lorsque enabled est true (par défaut si segmentSplitting est omis), les paragraphes denses, les tableaux GFM (le premier bloc inclut l'en-tête, le séparateur et la première ligne de données) et les longues listes sont divisés ; les sous-parties se rejoignent avec des sauts de ligne uniques (tightJoinPrevious). Définissez "enabled": false pour utiliser un seul segment par bloc de corps délimité par une ligne vide. Lorsque qualityRetrySplit est true (par défaut), les segments Markdown qui échouent à la validation AST après l'arrêt de la liste des modèles sont divisés progressivement et réessayés à partir du premier modèle. La liste s'arrête prématurément lorsque la même erreur de qualité s'est produite trois fois. maxQualityRetrySplitDepth (par défaut 3) limite les divisions récursives.
  • warnMarkdownSourceIssues Lorsque true (par défaut si omis), chaque exécution translate-docs réanalyse les segments Markdown à la recherche de délimiteurs risqués / de code en ligne non fermé, affiche des avertissements dans le terminal et remplace les lignes markdown_source_issues pour le chemin de fichier du cache de ce fichier. Définissez false pour ignorer les avertissements et les mises à jour SQLite pour ce bloc.
  • addFrontmatter Lorsque true (par défaut si omis), les fichiers Markdown traduits incluent les clés YAML : translation_last_updated, source_file_mtime, source_file_hash, translation_language, source_file_path, et lorsqu'au moins un segment contient des métadonnées de modèle, translation_models (liste triée des ID de modèle du fournisseur actif). Définissez sur false pour ignorer.
  • emphasisPlaceholders Par bloc docs[]. Lorsque true, masque les délimiteurs d'emphase markdown en tant qu'espaces réservés avant la traduction. Par défaut à true pour les paramètres régionaux CJK (zh, ja, ko) et pour les paramètres régionaux listés dans rtlLocales ; sinon, par défaut à false. Peut être remplacé via CLI --emphasis-placeholders / --no-emphasis-placeholders.
  • rtlLocales Tableau facultatif de codes BCP-47 traités comme RTL pour les valeurs par défaut des espaces réservés d'emphase (fusionné avec la détection RTL intégrée).

  • protectAttributes Facultatif. Noms d'attributs JSX/HTML supplémentaires dont les valeurs chaînes entre guillemets ne doivent pas être envoyées au traducteur. Fusionnés avec les valeurs par défaut intégrées (class, id, style, src, href, type, data-*, la plupart des aria-*, etc.). Insensible à la casse. S'applique à :

  • .astro extraction de parse-and-replace (balises HTML statiques et littéraux de chaîne après attr= à l'intérieur des blocs {expression}).

    • Extraction de placeholder MDX lors de la traduction de segments markdown/Astro (label, tooltip, et aria-label sur les balises JSX en majuscules, plus TabItem value lorsque cela est applicable).

Exemple : "protectAttributes": ["variant", "size"] conserve variant="primary" à l'intérieur de {items.map(...)} inchangé quel que soit le paramètre régional.

Vous pouvez également lister des attributs normalement traduisibles (par exemple "title" ou "aria-label") lorsque vous souhaitez que ces valeurs soient copiées telles quelles depuis l'anglais.

  • protectKeys Facultatif. Autres noms de propriétés d'objet dont les valeurs entre guillemets ne doivent pas être traduites à l'intérieur des blocs modèles {expression} et des littéraux objets MDX (par exemple label: à l'intérieur de <Tabs values={[ … ]}>). Fusionnés avec les valeurs par défaut intégrées (class, key, id, href, src, etc.). Insensible à la casse.

Exemple : "protectKeys": ["slug", "code"] ignore { slug: 'getting-started', title: 'Getting started' } → seul title est traduit lorsque slug est protégé.


Exemple (docsOutput.style = "flat" — chemins des captures d'écran + enveloppe facultative de liste de langues) :

Exemple de post-traitement en disposition plate (captures d'écran + bloc de liste des langues)
json
"docsOutput": {
  "style": "flat",
  "postProcessing": {
    "regexAdjustments": [
      {
        "description": "Per-locale screenshot folders",
        "search": "images/screenshots/[^/]+/",
        "replace": "images/screenshots/${translatedLocale}/"
      }
    ],
    "languageListBlock": {
      "start": "<small id=\"lang-list\">",
      "end": "</small>",
      "separator": " · ",
      "label": "local"
    }
  }
}

json ​

Tableau de premier niveau de pipelines de traduction JSON imbriqués. Utilisé uniquement lorsque features.translateJson est vrai (translate-json ou l'étape JSON de sync). Voir JSON.

ChampDescription
descriptionNote facultative pour CLI / status (non traduite).
contentPathsFichiers, répertoires ou globs .json source sous la racine du projet. Les fichiers d'espace de noms i18next typiques (public/locales/en/*.json) sont pris en charge : objets imbriqués, tableaux, interpolation {{var}} dans les valeurs de chaîne, et clés de suffixe pluriel indépendantes (key_one, key_other).
outputPathTemplateChemin de sortie requis par langue cible. Espaces réservés : {locale}, {LOCALE}, {llocale}, {stem}, {basename}, {extension}, {relativeToSourceRoot}.
targetLocalesSous-ensemble facultatif pour ce bloc ; sinon racine targetLocales.
keyPolicy.modeallowlist, denylist ou both.
keyPolicy.translateKeysChemins pointés / motifs à inclure lorsque le mode est allowlist ou both.
keyPolicy.skipKeysChemins pointés / motifs à exclure (la liste de refus par défaut inclut id, slug, href, url, key, code).

svg ​

Chemins et structure de niveau supérieur pour les fichiers SVG. La traduction s'exécute uniquement lorsque features.translateSVG est vrai (via translate-svg ou l'étape SVG de sync).

ChampDescription
sourcePathUn ou plusieurs répertoires ou motifs glob (par exemple "images/*.svg", "**/icons/*.svg"). Les motifs sont résolus par rapport à la racine du projet et analysés récursivement pour les fichiers .svg.
outputDirRépertoire racine pour la sortie SVG traduite.
style"flat" ou "nested" lorsque pathTemplate n'est pas défini.
pathTemplateChemin de sortie personnalisé pour les fichiers SVG. Espaces réservés : "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{relativeToSourceRoot}".
localePathLowercaseLorsque true, les modèles SVG intégrés flat / nested utilisent des segments de paramètres régionaux en minuscules. Les valeurs personnalisées de pathTemplate restent inchangées ; utilisez {llocale} pour des segments en minuscules.
forceLowercaseTexte traduit en minuscules lors du réassemblage du SVG. Utile pour les designs qui reposent sur des libellés entièrement en minuscules.

modelSuggestion (facultatif) ​

Poids ChrF et Arena, ainsi qu'un seuil de qualité facultatif, pour suggest-models et l'onglet Modèles du tableau de bord. L'index est basé uniquement sur la qualité. Omettez le bloc, ou omettez un profil, et ce profil conservera les poids intégrés. Le bloc n'est pas réécrit par --apply ou Mettre à jour la configuration ; ceux-ci n'écrivent que les identifiants de modèle. Un poids price hérité sur un profil est supprimé lors du chargement de la configuration.

  • quality — ChrF par défaut 0.55, Arena 0.45, seuil de qualité 0.7
  • price — ChrF par défaut 0.55, Arena 0.45, seuil de qualité 0.6

Chaque objet de profil requiert chrf et arena. Chaque valeur est finie et au moins 0, et au moins une est supérieure à 0. Elles sont normalisées pour que leur somme soit égale à 1, de sorte que 55 et 45 correspondent aux valeurs par défaut. qualityFloor est facultatif, dans la plage (0, 1], et représente la fraction du meilleur ChrF dans le pool de candidats. Les modèles en dessous du seuil, y compris tout modèle sans mesure ChrF, sont triés après ceux qui le dépassent. Les deux profils partagent le même mélange par défaut ; ils diffèrent par l'ordre de tri (--quality par index, --price par frontière de Pareto) et par le seuil.

json
"modelSuggestion": {
  "quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
  "price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}

glossary ​

ChampDescription
userGlossaryChemin vers un fichier CSV avec les colonnes Original language string (ou en), locale, Translation, Force (facultative) et Context (facultative) - une ligne par terme source et locale cible (locale peut être * pour toutes les cibles).
autoAddUserEditedToGlossaryLorsque true, les modifications du tableau de bord apportées aux chaînes de l'interface utilisateur peuvent être automatiquement ajoutées au glossaire de l'utilisateur.
contextFilesFichiers Markdown ou texte brut (.md, .markdown, .txt) relatifs au répertoire de travail, facultatifs, avec des explications sur le produit ou les fonctionnalités. Chargés au démarrage de la commande et injectés dans l'interface utilisateur, la documentation, le JSON, le SVG et les invites de relecture. Ne placez pas ces fichiers dans docs[].contentPaths à moins que vous ne souhaitiez également les traduire. Les URL sont rejetées. Le texte intégral est envoyé au fournisseur LLM configuré et peut apparaître dans les journaux --debug-failed — n'incluez pas de secrets ou d'informations personnelles identifiables.
contextMaxCharsNombre maximal de caractères de texte de fichier de contexte concaténé envoyé au modèle (par défaut 12000, limite stricte 100000). L'excès de texte est tronqué avec un avertissement.
labelCheckSkipsListe facultative de vérifications d'étiquettes d'interface utilisateur verrouillées à ignorer. Chaque entrée contient term (terme du glossaire anglais), locales (codes cibles, ou * pour chaque locale ; par défaut *), files facultatif (globaux relatifs au répertoire de travail), et note facultatif. Le terme reste une suggestion d'invite. Une omission s'applique lors de la prochaine exécution translate-docs.

translate-docs, translate-json et translate-svg tirent également des suggestions de chaque bloc d'interface utilisateur dont uiGlossary est true (valeur par défaut). Cela réutilise les traductions déjà stockées dans le strings.json de ce bloc. Définissez uiGlossary sur false sur un bloc pour l'exclure. translate-ui et proofread-ui n'utilisent pas ces catalogues comme suggestions. Les abréviations compactes des libellés d'interface (les formes avec un point final comme Alm., ou les compressions courtes à jeton unique comme Size → Tam) sont ignorées afin que les invites de document ne soient pas orientées vers des jetons {{…}} inventés. Les termes complets du produit et les traductions d'interface non abrégées sont toujours suggérés.

La colonne CSV facultative Context fournit des indications d'utilisation du terme dans la langue source (définition, usage grammatical, signification du produit). Elle n'est incluse que lorsque le terme correspond au lot actuel. La modification de la note Context d'un terme ou de tout contenu contextFiles invalide les segments mis en cache de la locale correspondante et les lignes de suivi de fichier lors de la prochaine exécution, de sorte que les traductions se rafraîchissent automatiquement. La modification d'un Translation préféré uniquement sur une ligne non forcée utilise toujours le cache existant, sauf si vous passez --force / --force-update. Une ligne Force ne manque que les segments dont la source contient ce terme, lorsque le texte stocké n'inclut pas déjà la traduction forcée. Les lignes de cache modifiées par l'utilisateur du tableau de bord sont conservées. Les catalogues d'interface utilisateur amorcent également un préfixe partagé de plusieurs mots comme son propre terme lorsque ce préfixe est une étiquette capitalisée (au moins deux mots de contenu) et que la traduction partagée est une courte phrase sans espace réservé. La traduction Markdown nécessite une étiquette d'interface utilisateur de deux à cinq mots pour conserver sa traduction de catalogue lorsque la source la cite comme l'intégralité de la plage en gras ou en code en ligne, dans un titre, ou sur une ligne qui n'est que cette étiquette. Une phrase en gras plus longue qui contient simplement le terme est une indication. La casse de titre à l'intérieur d'une phrase est une indication, de sorte que la traduction peut s'infléchir (le hindi Cursor account peut devenir कर्सर खाते plutôt que la forme de dictionnaire कर्सर खाता). Une étiquette avec un seul mot de contenu, tel que Sign in, reste une indication. La vérification ignore la capitalisation. Elle exige toujours la formulation du catalogue comme sous-chaîne, de sorte qu'une forme grammaticalement fléchie peut échouer. Cet échec est un avertissement : le segment est écrit, mis en cache avec un indicateur d'étiquette de glossaire, et listé à la fin de l'exécution dans glossary-review-*.md sous cacheDir. Ajoutez une entrée labelCheckSkips, ou passez --recheck-glossary-warnings, après l'avoir examinée. --force retraduit les lignes signalées ainsi que tous les autres segments.

Exemple :

json
{
  "glossary": {
    "userGlossary": "i18n/glossary.csv",
    "contextFiles": ["i18n/product-context.md", "i18n/billing-feature.md"],
    "contextMaxChars": 12000,
    "labelCheckSkips": [
      {
        "term": "Target language",
        "locales": ["uk"],
        "files": ["website/src/content/docs/docs/transform.md"],
        "note": "Inflected inside a bold phrase"
      }
    ]
  }
}

Générer un fichier CSV de glossaire vide :

bash
ai-i18n-tools glossary-generate

Pour ébaucher contextFiles à partir du dépôt, utilisez l'invite à copier-coller de l'agent dans Générer un fichier de contexte avec un agent IA. Consultez le Glossaire pour savoir comment les lignes de termes et les fichiers de contexte sont appliqués.

Publié sous licence MIT.