localization_settings

用量

localization_settings: {
  localization_level: permissive
  default_locale: en
  import_locale_defs: yes | no
}

階層 專案資訊清單檔案 localization_settings

預設值 無

定義

在專案中加入本地化設定後，您就能根據使用者的語言代碼，自訂 Looker 使用者介面中標籤和說明的顯示方式，也可以本地化 LookML 資訊主頁的特定部分。如要瞭解如何設定本地化模型，請參閱「本地化 LookML 模型」說明文件頁面。

使用 localization_settings 參數為專案啟用本地化功能，並指定專案處理本地化的方式：

• default_locale 參數會指定預設語言代碼字串檔案，定義模型中要本地化的字串。輸入檔案的確切名稱 (區分大小寫)，不含副檔名。舉例來說，如果字串檔案名為 en.strings.json，您會指定 default_locale: en。如要瞭解語言代碼字串檔案的運作方式，請參閱「將 LookML 模型本地化」說明文件頁面。
• localization_level 參數會指定模型中是否允許沒有翻譯的字串：
  • 如要讓 Looker IDE 針對未在預設語言代碼字串檔案中定義的任何標籤或說明，傳回 LookML 驗證錯誤，請將本地化層級設為 strict。
  • 將本地化層級設為 permissive，允許使用預設本地化字串檔案中未定義的標籤和說明。
• import_locale_defs 參數指定是否要將匯入專案的語言代碼定義，與匯入專案的語言代碼定義合併：
  • 設為 yes，即可將匯入專案的語言代碼定義與匯入專案的語言代碼定義合併。
  • 設為 no (預設值) 可忽略匯入專案的語言代碼定義。如果匯入專案有語言代碼定義，Looker 只會使用匯入專案的語言代碼定義。

如要進一步瞭解本地化設定，請參閱「本地化 LookML 模型」說明文件頁面。

範例

在資訊清單檔案中，指定預設語言代碼為「en」，本地化採用寬鬆政策，且應將匯入專案的語言代碼定義與匯入專案的語言代碼定義合併：

project_name: "flights"

localization_settings: {
  default_locale: en
  localization_level: permissive
  import_locale_defs: yes
}