Langue de l'interface utilisateur de l'outil
Le ai-i18n-tools localise sa propre interface utilisateur — le texte d'aide de la CLI, les messages de journal, de résumé et d'erreur fréquents, et le Tableau de bord de traduction — indépendamment du sourceLocale / targetLocales de votre projet. Aucune configuration n'est requise : par défaut, l'outil suit la locale de votre SE.
Résolution des paramètres régionaux
Les paramètres régionaux de l'interface utilisateur sont résolus à partir de ces sources, par ordre de priorité décroissant :
- Option globale
-L/--ui-lang <code>(p. ex.-L pt-BR). Passer-Lou--ui-langsans code affiche les langues fournies et quitte. La même liste est disponible avec l'option dans--help, et également à la fin deai-i18n-tools --help. - Variable d'environnement
AI_I18N_LANG(p. ex.export AI_I18N_LANG=es). - La clé de configuration
uiLanguagedansai-i18n-tools.config.json(chaîne BCP-47). - Les paramètres régionaux du système d'exploitation hôte (via
Intl.DateTimeFormat().resolvedOptions().locale).
Correspondance et repli
La locale demandée est comparée exactement aux langues d'interface utilisateur fournies ou à la variation la plus proche (par exemple, pt-PT se résout en pt-BR, et en-US se résout en en-GB) ; lorsqu'il n'y a pas de correspondance, elle se rabat sur la locale source (en-GB). Lorsqu'une langue d'interface utilisateur est demandée explicitement (via le drapeau, la variable d'environnement ou uiLanguage) mais qu'aucun bundle fourni ne correspond, la CLI affiche un avertissement unique indiquant que la locale par défaut sera utilisée ; une locale déduite uniquement du système d'exploitation hôte n'émet jamais d'avertissement.
Langues d'interface utilisateur fournies
Anglais (Royaume-Uni, source), allemand, espagnol, français, hindi, japonais, coréen, portugais (Brésil), chinois (simplifié), chinois (traditionnel).
Tableau de bord de traduction
Le Tableau de bord de traduction lit la locale résolue, le sens de la mise en page et le bundle de traduction depuis GET /api/ui-i18n et les applique au chargement (il définit <html lang> / dir et localise le balisage statique via les attributs data-i18n*).
Liens connexes
AI_I18N_LANG— remplacement de la variable d'environnementuiLanguage— remplacement de la clé de configuration-L/--ui-lang— remplacement de l'indicateur CLI (priorité la plus élevée)