Skip to content

ツールUIの言語

ai-i18n-toolsは、プロジェクトのsourceLocale / targetLocalesとは独立して、独自のユーザーインターフェース(CLIのヘルプテキスト、頻繁に表示されるログ/サマリー/エラーメッセージ、および翻訳ダッシュボード)をローカライズします。設定は不要です。デフォルトでは、ツールはOSのロケールに従います。

ロケールの解決

UIのロケールは、以下のソースから優先度の高い順に解決されます。

  1. -L / --ui-lang <code> グローバルフラグ(例: -L pt-BR)。
  2. AI_I18N_LANG 環境変数(例: export AI_I18N_LANG=es)。
  3. ai-i18n-tools.config.jsonuiLanguage 設定キー(BCP-47文字列)。
  4. ホストOSのロケール(Intl.DateTimeFormat().resolvedOptions().locale 経由)。

マッチングとフォールバック

要求されたロケールは、出荷済みのUI言語と正確に一致するか、最も近いバリエーションと一致します(例:pt-PTpt-BRに解決され、en-USen-GBに解決されます)。一致するものがない場合は、ソースロケール(en-GB)にフォールバックします。UI言語が明示的に要求された(フラグ、環境変数、またはuiLanguage経由)が、出荷済みのバンドルと一致しない場合、CLIはデフォルトロケールが使用されるという警告を一度だけ表示します。ホストOSからのみ推測されたロケールは警告を発しません。

組み込みのUI言語

英語 (英国, ソース), ドイツ語, スペイン語, フランス語, ヒンディー語, 日本語, 韓国語, ポルトガル語 (ブラジル), 中国語 (簡体字), 中国語 (繁体字)。

翻訳ダッシュボード

翻訳ダッシュボードは、GET /api/ui-i18n から解決されたロケール、レイアウト方向、および翻訳バンドルを読み取り、ロード時に適用します(<html lang> / dir を設定し、data-i18n* 属性を介して静的マークアップをローカライズします)。

関連項目

MITライセンスの下で公開されています。