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
}