Skip to content

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 :

  1. Option globale -L / --ui-lang <code> (p. ex. -L pt-BR). Passer -L ou --ui-lang sans code affiche les langues fournies et quitte. La même liste est disponible avec l'option dans --help, et également à la fin de ai-i18n-tools --help.
  2. Variable d'environnement AI_I18N_LANG (p. ex. export AI_I18N_LANG=es).
  3. La clé de configuration uiLanguage dans ai-i18n-tools.config.json (chaîne BCP-47).
  4. 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'environnement
  • uiLanguage — remplacement de la clé de configuration
  • -L / --ui-lang — remplacement de l'indicateur CLI (priorité la plus élevée)

Publié sous licence MIT.