Skip to content

CLI — Chaînes d'interface utilisateur ​

extract ​

Synopsis : ai-i18n-tools extract

Met à jour strings.json à partir des littéraux t("…") / i18n.t("…"), de la description facultative package.json et des entrées englishName du master groupé lorsque includeUiLanguageEnglishNames est activé (voir ui.uiExtractor ; ne lit pas languagesManifestPath). Régénère également le ui-languages.json de chaque bloc. Lorsque .html / .htm sont répertoriés dans ui.uiExtractor.extensions, capture également les chaînes de marqueur data-i18n / data-i18n-title / data-i18n-placeholder depuis le HTML. Parcourt chaque bloc ui qui possède sourceRoots. --ui-block limite l'exécution à un seul bloc (index, description ou chemin stringsJson). N'appelle pas de LLM.

Voir aussi : Présentation des chaînes d'interface utilisateur, Applications HTML simples


migrate-intlayer ​

Synopsis : ai-i18n-tools migrate-intlayer [paths...] [--write] [--report <path>] [--content-glob <glob>] [--t-import <specifier>]

Importer les dictionnaires Intlayer *.content.ts dans strings.json et les fichiers de locale plats, et réécrire les sites d'appel simples useIntlayer / getIntlayer en t('source string'). La chaîne est écrite en sourceLocale, qui peut être n'importe quelle langue. Exécution à blanc par défaut (le rapport est toujours écrit). --write initialise le catalogue et applique des réécritures sûres. N'appelle pas de LLM.

Le rapport assure la transition pour tout ce que --write laisse derrière lui, et se termine par un TODO étape par étape qui organise le reste du travail : un appel concret à t() ou JSX pour chaque site d'appel manuel, la ligne import { t }, les fichiers de dictionnaire et les éléments résiduels de IntlayerProvider à supprimer par la suite, les chaînes sources nécessitant extract puis translate-ui, et un script d'amorçage d'exécution i18next à coller en remplacement du module i18n de l'application. Le contrôle de la locale doit appeler i18n.changeLanguage ainsi que loadLocale. extract génère ui-languages.json, qui est importé par ce script d'amorçage. Ne modifiez pas manuellement strings.json, les fichiers de locale plats, ni ui-languages.json.

Options clés : --write, --report, --content-glob (par défaut **/*.content.ts), --t-import

Voir aussi : Migration depuis Intlayer


translate-intlayer ​

Synopsis : ai-i18n-tools translate-intlayer [paths...] [-l <codes>] [--ui-block <selector>] [--dry-run] [-j <n>]

Traduire les feuilles de locale manquantes et obsolètes dans les dictionnaires Intlayer *.content.ts sur place, en gardant les dictionnaires comme source de vérité. Contrairement à migrate-intlayer, cela ne déplace pas l'application hors d'Intlayer ; cela ne fait que remplir les feuilles t({ … }). Utilisez-le lorsque vous souhaitez conserver Intlayer à l'exécution et utiliser ai-i18n-tools comme moteur de traduction.

Il extrait chaque feuille t({ … }), alimente le strings.json du bloc d'interface utilisateur choisi avec le texte source, exécute le même moteur que translate-ui (sélection du fournisseur, glossaire, contexte de traduction et repli du modèle), puis réécrit les nouvelles chaînes par locale dans chaque objet t({ … }). Les modifications sont précises : seules les lignes de locale manquantes ou obsolètes sont modifiées, ainsi votre formatage et vos commentaires sont préservés. Les placeholders {token} d'Intlayer font un aller-retour vers {{token}} pour la traduction.

Une feuille+locale est traduite lorsque la locale est absente de la feuille (manquante), ou lorsque le texte de la locale source a changé depuis la dernière exécution pour cette locale (obsolète). L'obsolescence est suivie dans cacheDir, donc la modification de cette chaîne source retraduit cette feuille lors de la prochaine exécution. La langue source est sourceLocale et peut être n'importe quelle langue. --dry-run signale les nombres manquants/obsolètes sans appeler de LLM ni écrire quoi que ce soit. Nécessite features.translateUIStrings et le stringsJson du bloc d'interface utilisateur (identique à translate-ui).

Options clés : -l / --locale, --ui-block, --dry-run, -j / --concurrency

[paths...] : fichiers/répertoires/globs à analyser (par défaut : le sourceRoots du bloc). -l / --locale : locales cibles séparées par des virgules à remplir (par défaut : les targetLocales configurées du bloc). --ui-block : index basé sur zéro, description ou chemin stringsJson (par défaut : bloc 0). -j parallélise les locales.

Voir aussi : migrate-intlayer, Migration depuis Intlayer


mark-html ​

Synopsis : ai-i18n-tools mark-html [paths...] [--write]

Insère des marqueurs data-i18n / data-i18n-title / data-i18n-placeholder nus dans le HTML afin que le texte source ne soit écrit qu'une seule fois (sur l'élément lui-même). Analyse les fichiers/répertoires/globs donnés (par défaut : .html / .htm sous le sourceRoots de chaque bloc). Exécution à blanc par défaut (indique le nombre d'ajouts par fichier et tout élément à contenu mixte nécessitant un <span data-i18n> manuel) ; --write applique les modifications. Idempotent, respecte data-i18n-ignore (ignore l'élément et son sous-arbre), ne touche jamais aux éléments de type code (code, pre, kbd, samp, var) ni au texte vide ou purement numérique, et n'émet jamais de marqueur valué. N'appelle pas de LLM.

Options clés : --write

Voir aussi : Marquage HTML pour la traduction


generate-ui-languages ​

Synopsis : ai-i18n-tools generate-ui-languages [--master <path>] [--dry-run]

Écrit ui-languages.json dans languagesManifestPath (par défaut {ui.flatOutputDir}/ui-languages.json) en utilisant sourceLocale + targetLocales et le data/ui-languages-complete.json groupé (ou --master). Avertit et émet des espaces réservés TODO pour les locales manquantes dans le fichier maître. Si vous avez un manifeste existant avec des valeurs label ou englishName personnalisées, elles seront remplacées par les valeurs par défaut du catalogue maître — examinez et ajustez le fichier généré par la suite.

Options clés : --master, --dry-run


translate-ui ​

Synopsis : ai-i18n-tools translate-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

Traduit uniquement les chaînes d'interface utilisateur (strings.json → JSON de locale). Nécessite features.translateUIStrings.

Options clés : -l / --locale, --force, --dry-run, -j / --concurrency

-l / --locale : locales cibles séparées par des virgules (par défaut : configuration targetLocales moins sourceLocale). --force : re-traduire toutes les entrées par locale (ignorer les traductions existantes). --dry-run : aucune écriture, aucun appel d'API. -j parallélise les locales ; au sein de chaque locale, la configuration uiBatchConcurrency (par défaut 2) parallélise les lots de LLM (blocs de 50 chaînes, puis groupes de pluriels). Il n'y a pas d'option CLI pour uiBatchConcurrency. Chaque lot réussi est écrit dans strings.json et le fichier de locale plat avant le début du lot suivant. sync-ui et l'étape d'interface utilisateur de sync utilisent la même écriture.

Une traduction stockée dont les espaces réservés ne correspondent pas à sa source est traduite à nouveau. La vérification couvre un nom renommé ({schedule} devenant {cronograma}), un jeton supprimé ou inventé, et un changement de spécification de format ({price:,.2f} devenant {price}). Le compte est affiché avant le lot, y compris sur --dry-run. Une ligne dont le modèle est user-edited est laissée en place et fait seulement l'objet d'un avertissement. Une chaîne qui ne contient que des espaces réservés et de la ponctuation, telle que {state} · {title}, est copiée et n'est pas envoyée à un modèle. Un lot qui renomme un espace réservé est rejeté et le modèle suivant de la chaîne est essayé avec cette erreur ajoutée. Le tableau de bord signale les mêmes lignes et demande confirmation avant d'enregistrer une traduction qui rompt un espace réservé.


sync-ui ​

Synopsis : ai-i18n-tools sync-ui [-l <codes>] [--force] [--dry-run] [-j <n>]

Extrait, puis traduit les chaînes d’interface utilisateur (nécessite features.translateUIStrings). Interface utilisateur uniquement — pas de documentation, de SVG ou de json[]. Mêmes options -l, --force, --dry-run et -j que translate-ui.


proofread-ui ​

Synopsis : ai-i18n-tools proofread-ui [-l <code>] [--chunk <n>] [--dry-run] [--json] [-j <n>]

Exécute extract en premier (nécessite features.translateUIStrings) afin que chaque catalogue sélectionné corresponde à la source, puis effectue une révision LLM des chaînes d'interface utilisateur de la locale source (orthographe, grammaire). --ui-block limite l'extraction et la révision à un seul bloc. Les suggestions terminologiques proviennent uniquement du CSV glossary.userGlossary (même portée que translate-ui — les catalogues d'interface utilisateur ne sont pas réintégrés, de sorte que les mauvaises copies ne sont pas renforcées en tant que glossaire). Utilise le fournisseur LLM actif (sa variable d'environnement de clé API).

Renvoie le code 1 en cas d'échec (feature flag manquant, échec de l'extraction, catalogue manquant ou invalide, clé API manquante, ou lorsque tous les lots échouent) ; renvoie le code 0 lorsque l'exécution se termine avec succès (les résultats sont fournis à titre indicatif). Écrit proofread-ui-results_<timestamp>.log sous cacheDir sous forme de rapport lisible (résumé, problèmes, lignes non examinées et lignes validées pour chaque chaîne) ; le terminal affiche uniquement les totaux du résumé et les problèmes (aucune ligne [ok] par chaîne). Si un lot échoue, ou si une réponse du modèle est plus courte que le lot et ne contient pas de index utilisable pour chaque emplacement, ces chaînes sont considérées comme non examinées. Leurs problèmes sont ignorés afin d'éviter qu'un tableau trop court ne soit appliqué aux mauvaises chaînes. Affiche le nom du fichier journal sur la dernière ligne. Avec --json, la sortie lisible est dirigée vers stderr. Les liens utilisent path:line, comme le bouton de lien des chaînes dans l'interface du tableau de bord.

Options clés : -l / --locale, --chunk (par défaut 50), --dry-run, --json, -j / --concurrency


export-ui-xliff ​

Synopsis : ai-i18n-tools export-ui-xliff [-l <codes>] [-o <dir>] [--untranslated-only] [--dry-run]

Exporte strings.json vers XLIFF 2.0 (un .xliff par locale cible). Lecture seule ; pas d’API.

Options clés : -l / --locale, -o / --output-dir, --untranslated-only, --dry-run

-o / --output-dir : répertoire de sortie (par défaut : même dossier que le catalogue). --untranslated-only : uniquement les unités pour lesquelles il manque une traduction pour cette locale.

Publié sous licence MIT.