工具介面語言
ai-i18n-tools 會將其使用者介面(CLI 說明文字、高流量日誌/摘要/錯誤訊息以及翻譯儀表板)本地化,獨立於您專案的 sourceLocale / targetLocales。無需設定:該工具預設會遵循您的作業系統地區設定。
語言環境解析
UI 語言環境會從以下來源解析,按優先級由高至低排列:
-L/--ui-lang <code>全域旗標 (例如-L pt-BR)。傳遞-L或--ui-lang且不帶任何代碼,會列印隨附的語言並結束。相同的清單位於--help中的選項,以及ai-i18n-tools --help的結尾處。AI_I18N_LANG環境變數 (例如export AI_I18N_LANG=es)。uiLanguage設定金鑰位於ai-i18n-tools.config.json中 (BCP-47 字串)。- 主機作業系統地區設定 (透過
Intl.DateTimeFormat().resolvedOptions().locale)。
比對與後備
所要求的地區設定會與提供的使用者介面語言進行精確匹配或透過最接近的變體進行匹配(例如 pt-PT 解析為 pt-BR,而 en-US 解析為 en-GB);當沒有匹配項時,它會回退到來源地區設定(en-GB)。當明確要求使用者介面語言(透過標誌、環境變數或 uiLanguage)但沒有已提供的套件匹配時,CLI 會發出一次性警告,表示將使用預設地區設定;僅從主機 OS 推斷出的地區設定永遠不會發出警告。
內建介面語言
英語(英國,來源)、德語、西班牙語、法語、印地語、日語、韓語、葡萄牙語(巴西)、簡體中文、繁體中文。
翻譯儀表板
翻譯儀表板會從 GET /api/ui-i18n 讀取已解析的地區設定、版面配置方向和翻譯套件,並在載入時套用它們(它會設定 <html lang> / dir,並透過 data-i18n* 屬性本地化靜態標記)。
相關內容
AI_I18N_LANG— 環境變數覆寫uiLanguage— 設定鍵覆寫-L/--ui-lang— CLI 旗標覆寫(最高優先級)