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 soussrc/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 :
{
"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 :
{
"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 :
translationModelsListe ordonnée préférée des ID de modèle (ID amont bruts, sans préfixeprovider/; les ID OpenRouter conservent leur forme nativevendor/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, pourtranslate-ui, la génération au pluriel (Étape 0 et Passe B) etproofread-ui. Essayée après toute entréelocaleModelscorrespondante pour la locale cible, avanttranslationModels.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 (uiModelspour l'interface utilisateur) ettranslationModels. Les clés de locale normalisées en double sont rejetées lors du chargement de la configuration.baseUrlURL de base compatible OpenAI. Remplace l'URL de base prédéfinie ; requise pour un fournisseur non prédéfini.apiKeyEnvVariable d'environnement contenant la clé API. Remplace la variable d'environnement prédéfinie.headersEn-têtes HTTP supplémentaires envoyés avec chaque requête à ce fournisseur.maxTokensNombre maximal de jetons de complétion par requête. Par défaut :8192.temperatureTempérature d'échantillonnage. Par défaut :0.2.requestTimeoutDélai d'attente maximal en secondes pour chaque requête adressée à ce fournisseur. Remplace lerequestTimeout/requestTimeoutMsde 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 de120secondes. Définissez un seul desrequestTimeoutetrequestTimeoutMssur le même objet.requestTimeoutMsDélai d'attente maximal en millisecondes pour chaque requête adressée à ce fournisseur. Remplace lerequestTimeout/requestTimeoutMsde 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 est120000(120 secondes). Définissez un seul desrequestTimeoutetrequestTimeoutMssur 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 deusage.costsignalé 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 ligneapi_calls.
La source du coût est résolue dans cet ordre :
- une entrée
modelPricingcorrespondante (remplace cette valeur par défaut du fournisseur) ; - un coût signalé par le fournisseur (jamais remplacé) ;
- ce taux
pricing; - 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 } }. Remplacepricingpour cet ID de modèle. Appliqué au moment de l'appel lorsque le fournisseur a omisusage.cost, et stocké avec l'appel.zeroDataRetention(facultatif,providers.cheaperinferenceuniquement) Lorsquetrue, les requêtes de chat envoient"zdr": trueetlist-models,check-models, etsuggest-modelschargentGET /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) :
| Fournisseur | URL de base | Variable d'environnement de la clé API |
|---|---|---|
alibaba | https://dashscope-intl.aliyuncs.com/compatible-mode/v1 | ALIBABA_API_KEY |
anthropic | https://api.anthropic.com/v1 | ANTHROPIC_API_KEY |
apikeyfan | https://api.apikey.fan/v1 | APIKEYFAN_API_KEY |
cerebras | https://api.cerebras.ai/v1 | CEREBRAS_API_KEY |
cheaperinference | https://api.cheaperinference.com/v1 | CHEAPERINFERENCE_API_KEY |
deepseek | https://api.deepseek.com | DEEPSEEK_API_KEY |
gemini | https://generativelanguage.googleapis.com/v1beta/openai | GOOGLE_API_KEY |
groq | https://api.groq.com/openai/v1 | GROQ_API_KEY |
mistral | https://api.mistral.ai/v1 | MISTRAL_API_KEY |
nvidia | https://integrate.api.nvidia.com/v1 | NVIDIA_API_KEY |
ollama | http://localhost:11434/v1 | (aucun) |
openai | https://api.openai.com/v1 | OPENAI_API_KEY |
openrouter | https://openrouter.ai/api/v1 | OPENROUTER_API_KEY |
xai | https://api.x.ai/v1 | XAI_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
"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
"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
"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
| Champ | Pipeline | Description |
|---|---|---|
translateUIStrings | 1 | Extrait 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). |
translateDocs | 2 | Traduire 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". |
translateJson | 3 | JSON 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
trueomis sans rien à traduire est ignoré : aucun bloc d'interface utilisateur n'asourceRoots, aucun bloc de documentation n'acontentPathsoudocusaurusCatalogDir,json[]n'a pas decontentPaths, ousvgn'est pas défini. - Écrire l'indicateur comme
truelorsque ce pipeline n'a pas de travail est une erreur de configuration. - Écrire
falsedésactive ce pipeline poursyncmême si des sources existent. --no-ui,--no-docs,--no-jsonet--no-svgignorent 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.
descriptionNote optionnelle pour les personnes lisant la configuration (non envoyée au modèle). Affichée en tant queui[i] — descriptiondans les en-têtes de commande,status,statisticset le tableau de bord.sourceRootsRépertoires ou motifs glob (relatifs au cwd) analysés pour les appelst("…"). Prend en charge les motifs commesrc/ou["src/**/*.ts"]. Un bloc avec une liste vide est ignoré à moins que--ui-blockne le nomme, ce qui constitue une erreur.stringsJsonChemin vers le fichier de catalogue principal de ce bloc. Mis à jour parextract.flatOutputDirRépertoire où les fichiers JSON par locale de ce bloc sont écrits (de.json, etc.).flatOutputLorsquetrue(par défaut),translate-uiécrit un fichier JSON plat par locale. Définissezfalsepour n'émettre que gettext ou resx. Un bloc avecflatOutput: falsedoit définirgettextouresx.resxSortie .NET.resxfacultative.outputDir(par défautResources) etbaseName(par défautSharedResource) écrivent{baseName}.resxplus{baseName}.{culture}.resx.writeNeutral(vrai par défaut) place le texte source dans le fichier neutre afin queResourceManagerpuisse se rabattre.localeFormatestbcp47(par défaut,pt-BR) ouposix(pt_BR).ingestExistingResx(vrai par défaut) lit les satellites pendantextract.neutralFilemappe les clés nommées héritées telles queLoginButtonvia 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 avecflatOutput: falsedoit définirgettextouresx.gettextSortie GNU gettext facultative pour ce bloc.outputDir(par défaut./locales) reçoit<locale>/LC_MESSAGES/<domain>.poet, lorsquecompileMoest vrai (par défaut), le.mocorrespondant.domainest par défautmessages.potPathest le catalogue de modèles.ingestExistingPo(par défauttrue) remplit les emplacementsstrings.jsonvides à partir des valeursmsgstrnon floues pendantextractet ne remplace pas une traduction non vide ou éditée par l'utilisateur.localeFormatestposix(par défaut,pt_BR) oubcp47(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.targetLocalesListe de locales facultative pour ce bloc. Lorsqu'elle est omise ou vide, le bloc utilise la racinetargetLocales.languagesManifestPathChemin facultatif oùextractetgenerate-ui-languagesécrivent leui-languages.jsonde ce bloc. Lorsqu'il est omis, le bloc 0 utilise la racinelanguagesManifestPath(qui par défaut est le{flatOutputDir}/ui-languages.jsonde ce bloc). Les blocs ultérieurs utilisent{flatOutputDir}/ui-languages.jsonpar défaut.uiGlossaryLorsquetrue(par défaut), lestrings.jsonde ce bloc est une source d'indices de glossaire pourtranslate-docs,translate-jsonettranslate-svg.translate-ui,proofread-uiet le linting de source n'utilisent queglossary.userGlossary. Définissezfalsepour exclure un catalogue de ces indices (par exemple, un catalogue de chaînes CLI qui ne devrait pas orienter la documentation).uiExtractor.funcNames(oureactExtractor.funcNameshérité) Noms de fonctions supplémentaires à analyser (par défaut :["t", "i18n.t"]).uiExtractor.extensions(oureactExtractor.extensionshérité) Extensions de fichier à inclure (par défaut :[".js", ".jsx", ".ts", ".tsx"]). Ajoutez.astropour le frontmatter Astro et les expressions de modèle.uiExtractor.includePackageDescription(oureactExtractor.includePackageDescriptionhérité) Lorsquetrue(par défaut),extractinclut égalementpackage.jsondescriptioncomme chaîne d'interface utilisateur lorsqu'il est présent. Définissezfalsesur des blocs supplémentaires afin que la même description ne soit pas extraite dans chaque catalogue.uiExtractor.packageJsonPath(oureactExtractor.packageJsonPathhérité) Chemin personnalisé vers le fichierpackage.jsonutilisé pour cette extraction de description facultative.uiExtractor.includeUiLanguageEnglishNames(oureactExtractor.includeUiLanguageEnglishNameshé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) oudotnet({0},{0,-10},{0:format}uniquement). Dans le styledotnet, un signe de pourcentage est un texte littéral et les accolades doubles sont des accolades littérales. Le modèleui-dotnetdéfinitdotnet.uiExtractor.excludeMotifs minimatch, relatifs à la racine du projet, ignorés après l'analyse.bin,obj,.vs,TestResultsetpackagessont déjà ignorés par nom de répertoire. Les modèlesui-dotnetetui-dotnet-resxexcluent**/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
cacheDirRépertoire de cache SQLite (partagé par tous les blocsdocs). 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 —cacheDircrée sa propre base de données SQLite et n'est pas compatible avec d'autres schémas.suggest-modelsstocke é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
.gitignoreou.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 utilisantai-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.
# 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ée | Clé/comportement actuel |
|---|---|
documentations | docs |
markdownOutput | docs[].docsOutput |
jsonSource | docs[].docusaurusCatalogDir |
openrouter de niveau supérieur | providers.openrouter + provider: "openrouter" |
features.translateMarkdown | features.translateDocs |
features.translateJSON | supprimé (utiliser docs[].docusaurusCatalogDir ou json[]) |
features.extractUIStrings | supprimé (extract s'exécute avant la traduction de l'interface utilisateur) |
glossary.uiGlossary et glossary.uiGlossaryFromStringsJson | supprimés ; le chargement de la configuration échoue. Utilisez ui[].uiGlossary (booléen, valeur par défaut true) |
ui.reactExtractor | ui.uiExtractor (l'alias est toujours accepté) |
svg.svgExtractor.forceLowercase | svg.forceLowercase |
Sources de contenu
descriptionNote facultative lisible par l'humain pour ce bloc (non utilisée pour la traduction). Préfixe dans le titretranslate-docs🌐lorsqu'elle est définie ; également affichée dans les en-têtes de sectionstatus.contentPathsCorps de pages Markdown/MDX et modèles.astroà traduire (translate-docsanalyse ceux-ci pour.md,.mdxet.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.sourceFilesAlias facultatif fusionné danscontentPathsau chargement.targetLocalesSous-ensemble facultatif de paramètres régionaux pour ce bloc uniquement (sinon utilisetargetLocalesau niveau racine). Les paramètres régionaux de documentation effectifs sont l'union entre tous les blocs.docusaurusCatalogDirFacultatif. Répertoire source des catalogues d'étiquettes JSON Docusaurus pour ce bloc (par exemple,"i18n/en"dedocusaurus write-translations). Les corps de page proviennent toujours decontentPaths;docusaurusCatalogDirne fournit que le JSON de l'interface/shell, pas le MDX.nextraMetaGlobGlob(s) facultatif(s) pour_meta.ts/_meta.tsx/_meta.jsNextra sousdocsRoot. LorsquedocsOutput.styleest"nextra"et que ceci est omis, tous les fichiers_metasousdocsRootsont collectés automatiquement.nextraMetaTranslatableKeysNoms de propriétés facultatifs dont les valeurs de chaîne sont traduites dans les objets_metaNextra (par défaut :title,display,breadcrumb).nextraDictionaryPathModule de dictionnaire de thème Nextra anglais facultatif (par exemple,"app/_dictionaries/en.ts"). Traduit en{dir}/{locale}.tspendanttranslate-docs.nextraDictionaryOutputTemplateModèle de sortie facultatif pour les modules de dictionnaire de locale (par défaut :{dir}/{locale}.tspar rapport au répertoire du dictionnaire).
docsOutput
Disposition de la sortie pour ce bloc.
outputDirRé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.localeSubpathSegment de chemin entre{locale}/et{relativeToDocsRoot}pourdoc-system(obligatoire lors de l'utilisation directe destyle: "doc-system"; prédéfini lors de l'utilisation d'un alias). Utilisez""pour les dossiers de locale de style Starlight.docsOutput.docsRootRacine des documents source pour la mise en page Docusaurus (par exemple,"docs"). Par défaut"docs"si omis.docsOutput.pathTemplateChemin de sortie Markdown personnalisé. Espaces réservés :"{outputDir}","{locale}","{LOCALE}","{llocale}","{relPath}","{stem}","{basename}","{extension}","{docsRoot}","{relativeToDocsRoot}".docsOutput.jsonPathTemplateChemin de sortie JSON personnalisé pour les fichiers d'étiquettes. Prend en charge les mêmes espaces réservés quepathTemplate.docsOutput.localePathLowercaseLorsquetrue, les mises en page de sortie intégrées (nested,flat,doc-systemsanspathTemplate) utilisent des segments de paramètres régionaux en minuscules dans les chemins. Par défautfalse;astro-starlightetdoc-systemaveclocaleSubpathvide par défaut àtrueau chargement de la configuration.docsOutput.flatPreserveRelativeDirLorsquedocsOutput.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éfautfalse.docsOutput.rewriteRelativeLinksRéécrire les liens relatifs après la traduction (activé automatiquement lorsquedocsOutput.style = "flat"et sanspathTemplatepersonnalisé).docsOutput.linkRewriteDocsRootRacine 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.rewriteVitepressLinksLorsquetrue, exécuter le normaliseur de liens VitePress après la traduction. Activé par défaut lorsquedocsOutput.styleest"vitepress". À utiliser avec toute mise en pagedoc-systemoù les dossiers de locale se trouvent à côté des fichiers de locale source sousdocsRoot. La langue source estsourceLocaleet peut être n'importe quelle langue. Réécrit les cheminsdocs/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.rewriteNextraLinksLorsquetrue, exécuter le normaliseur de liens Nextra après la traduction. Activé par défaut lorsquedocsOutput.styleest"nextra". Réécrit les cheminscontent/en/…et.mdxrelatifs vers des routes de site neutres en locale (/guide/…) pour Next.jsi18n. Voir Intégration Nextra — Conventions de liens.docsOutput.fumadocsParser"dot"(par défaut) ou"dir". Dot écritstem.{locale}.mdxà côté des fichiers de locale source ; dir écrit des dossiers de locale comme Nextra. La langue source estsourceLocaleet peut être n'importe quelle langue. Voir Intégration Fumadocs — Disposition de la page.docsOutput.rewriteFumadocsLinksLorsquetrue, exécuter le normaliseur de liens Fumadocs après la traduction. Activé par défaut lorsquedocsOutput.styleest"fumadocs". Réécrit les chemins de contenu et les liens.mdxrelatifs vers les routes/docs/….docsOutput.fumadocsUiCatalogFacultatif. Amorçage du catalogue de remplacement de l'interface utilisateur Fumadocs + traduction à l'intérieur detranslate-docs. Champs :sourcePath(par exemplelib/layout.shared.ts),catalogPath(JSON anglais généré),outputPathTemplatefacultatif (par défaut :ui.{locale}.jsonà côté decatalogPath).docs[].fumadocsMetaGlobGlob(s) facultatif(s) pour la collectionmeta.jsonlorsquedocsOutput.styleest"fumadocs". Par défaut :meta.jsonrécursif sousdocsOutput.docsRoot.docs[].fumadocsMetaTranslatableKeysNoms des propriétés dont les valeurs de chaîne sont traduites dans lemeta.jsonFumadocs (par défaut :title,description).docsOutput.localizedAssetsRenommage facultatif des URL d'images et d'icônes dans le HTML traduit lorsqu'un fichier de langue existe. Champs :include(par défautimg/**),pattern(par défaut{stem}-{locale}{ext}),onlyIfExists(par défauttrue),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}. Leurl()CSS n'est pas réécrit. Voir Pages HTML.docsOutput.htmlListe 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.formatestlinksouselect.languageList.labelestlocal,englishouboth.hreflang.siteUrlpréfixe les liens alternatifs ; lorsqu'il est omis, les liens sont relatifs et un avertissement est consigné.hreflang.xDefaulta pour valeur par défautsourceLocale.hreflang.stripIndexHtmltransformeindex.htmlen URL de répertoire. Pour le HTML,docsRootest supprimé avant l'ajout du dossier de langue (site/index.html→site/{locale}/index.htmllorsquedocsRootestsite). Voir Pages HTML.docsOutput.vitepressThemeCatalogFacultatif. Initialisation et traduction du catalogue de thème, navigation et barre latérale VitePress danstranslate-docs. Champs :configPath(configuration VitePress avec les chaînes du thème),catalogPath(JSON imbriqué anglais généré),outputPathTemplatefacultatif (par défaut :theme.{locale}.jsonà côté decatalogPath).
Post-traitement
docsOutput.postProcessingTransformations 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 avantaddFrontmatter.docsOutput.postProcessing.regexAdjustmentsListe ordonnée de{ "description"?, "search", "replace" }.searchest un motif d'expression régulière (une chaîne simple utilise l'indicateurg, ou/pattern/flags).replaceprend 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écessitelanguagesManifestPath(ou un manifeste àui.flatOutputDir/ui-languages.json) pour les étiquettes endonymes lorsquelabel: "local".
Comportement et métadonnées
translateFrontmatterFieldsMême niveau quedocsOutput(par blocdocs[]). Par défauttrue: 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, étiquettesprev/next). Définissezfalsepour 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.segmentSplittingMême niveau quedocsOutput(par blocdocs[]). Segments optionnels plus fins pour l'extractiontranslate-docs:{ "enabled", "maxCharsPerSegment"?, "splitPipeTables"?, "splitDenseParagraphs"?, "maxLinesPerParagraphChunk"?, "splitLongLists"?, "maxListItemsPerChunk"?, "qualityRetrySplit"?, "maxQualityRetrySplitDepth"? }. Lorsqueenabledesttrue(par défaut sisegmentSplittingest 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": falsepour utiliser un seul segment par bloc de corps délimité par une ligne vide. LorsquequalityRetrySplitesttrue(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éfaut3) limite les divisions récursives.warnMarkdownSourceIssuesLorsquetrue(par défaut si omis), chaque exécutiontranslate-docsré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 lignesmarkdown_source_issuespour le chemin de fichier du cache de ce fichier. Définissezfalsepour ignorer les avertissements et les mises à jour SQLite pour ce bloc.addFrontmatterLorsquetrue(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 surfalsepour ignorer.emphasisPlaceholdersPar blocdocs[]. Lorsquetrue, masque les délimiteurs d'emphase markdown en tant qu'espaces réservés avant la traduction. Par défaut àtruepour les paramètres régionaux CJK (zh,ja,ko) et pour les paramètres régionaux listés dansrtlLocales; sinon, par défaut àfalse. Peut être remplacé via CLI--emphasis-placeholders/--no-emphasis-placeholders.rtlLocalesTableau 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).
protectAttributesFacultatif. 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 desaria-*, etc.). Insensible à la casse. S'applique à :.astroextraction de parse-and-replace (balises HTML statiques et littéraux de chaîne aprèsattr=à l'intérieur des blocs{expression}).- Extraction de placeholder MDX lors de la traduction de segments markdown/Astro (
label,tooltip, etaria-labelsur les balises JSX en majuscules, plusTabItemvaluelorsque cela est applicable).
- Extraction de placeholder MDX lors de la traduction de segments markdown/Astro (
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.
protectKeysFacultatif. 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 exemplelabel:à 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)
"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.
| Champ | Description |
|---|---|
description | Note facultative pour CLI / status (non traduite). |
contentPaths | Fichiers, 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). |
outputPathTemplate | Chemin de sortie requis par langue cible. Espaces réservés : {locale}, {LOCALE}, {llocale}, {stem}, {basename}, {extension}, {relativeToSourceRoot}. |
targetLocales | Sous-ensemble facultatif pour ce bloc ; sinon racine targetLocales. |
keyPolicy.mode | allowlist, denylist ou both. |
keyPolicy.translateKeys | Chemins pointés / motifs à inclure lorsque le mode est allowlist ou both. |
keyPolicy.skipKeys | Chemins 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).
| Champ | Description |
|---|---|
sourcePath | Un 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. |
outputDir | Répertoire racine pour la sortie SVG traduite. |
style | "flat" ou "nested" lorsque pathTemplate n'est pas défini. |
pathTemplate | Chemin de sortie personnalisé pour les fichiers SVG. Espaces réservés : "{outputDir}", "{locale}", "{LOCALE}", "{llocale}", "{relPath}", "{stem}", "{basename}", "{extension}", "{relativeToSourceRoot}". |
localePathLowercase | Lorsque 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. |
forceLowercase | Texte 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éfaut0.55, Arena0.45, seuil de qualité0.7price— ChrF par défaut0.55, Arena0.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.
"modelSuggestion": {
"quality": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.7 },
"price": { "chrf": 0.55, "arena": 0.45, "qualityFloor": 0.6 }
}glossary
| Champ | Description |
|---|---|
userGlossary | Chemin 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). |
autoAddUserEditedToGlossary | Lorsque 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. |
contextFiles | Fichiers 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. |
contextMaxChars | Nombre 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. |
labelCheckSkips | Liste 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 :
{
"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 :
ai-i18n-tools glossary-generatePour é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.