语言区域解析
了解哪些已保存的配置适用于请求的语言、地区或文字体系,以及指令、品牌语调、模型和术语如何使用这些配置。
请求会使用为以下语言区域保存的配置:请求本身的语言区域、包含它的更宽泛语言区域,以及 *。为更具体的语言区域或同一语言的其他地区保存的配置则不适用。适用配置的处理方式因资源类型而异:指令会累积,品牌语调只选用一个变体,模型会按顺序逐一尝试,而自定义译文还必须使用与请求一致的文字体系。
有关如何选择语言标签,请阅读语言。本参考文档说明这些标签传入本地化引擎后的处理方式。
哪些配置适用 #
处理语言区域时,引擎会根据 CLDR 数据,将等价写法视为同一个语言区域:zh、zh-CN、zh-Hans 和 zh-Hans-CN 都表示中国使用的简体中文。未指定地区的语言区域代表其默认地区。请求 es 就是请求西班牙使用的西班牙语(es-ES),pt 代表 pt-BR,de 代表 de-DE。
如果配置的语言区域属于以下任一种情况,该配置就适用于请求:
*,适用于所有语言区域。- 请求的语言区域,包括其所有等价写法。
- 包含请求语言区域的更宽泛语言区域。
de适用于de-CH,zh-Hant适用于zh-TW。
其他语言区域的配置均不适用,包括更具体的地区配置(例如对 de 请求使用 de-CH 配置),以及同一语言的其他地区配置(例如对 de-CH 请求使用 de-DE 配置)。
| 请求 | 适用 | 不适用 |
|---|---|---|
es | *, es, es-ES | es-MX, es-419 |
es-MX | *, es, es-MX | es-ES, es-419 |
de-CH | *, de, de-CH | de-DE, de-AT |
zh-TW | *, zh, zh-Hant, zh-TW | zh-Hans, zh-CN |
sr | *, sr, sr-Cyrl | sr-Latn |
像 es-419 这样的地区组本身就是一个独立的语言区域。它的配置仅适用于 es-419 请求,不适用于 es-MX 或 es-AR 请求。
对于设有源语言区域的资源,也就是模型配置和术语表中的术语,同样的规则也适用于源语言区域。为源语言区域 en-GB 保存的术语不适用于源语言区域为 en 的内容,因为 en 代表 en-US。
要让一种语言的所有地区共用指导内容,请将其保存到不带地区的语言代码下,例如 es。只有当指导内容专门面向某个地区的受众时,才将其保存到该地区。
匹配层级决定适用配置的顺序 #
本地化引擎按匹配层级对适用配置排序:首先是请求的语言区域,其次是更宽泛的语言区域,最后是 *。同一层级内,更具体的写法优先。因此,对于 de 请求,de-DE 变体排在 de 变体之前。
如果需求涉及特定地区,请明确使用带有该地区的语言区域。同时,请注意区分不同的语言标识符:no 和 nb 是不同的代码,为其中一个保存的配置不适用于另一个。
不同资源使用适用配置的方式 #
| 资源 | 结果 |
|---|---|
| 规则 | 适用的预定义指令和自定义指令会按语言区域的相关程度依次累积。具体规则不会覆盖宽泛规则。 |
| 品牌语调 | 选用匹配度最高的变体。若仍有并列,则依次按创建时间和 ID 确定结果,确保选择稳定一致。 |
| 模型 | 尝试顺序依次由目标语言区域的匹配层级、源语言区域的匹配层级、目标语言区域的具体程度、源语言区域的具体程度,以及配置的排名决定。 |
| 术语表 | 使用其他文字体系的自定义译文会被排除。其余候选项先按语言区域排序,再按源文本去重,随后通过检索选出适用的上下文。 |
| 人工审核 | 如果审核策略中的任一语言适用于请求,或策略未指定任何语言,该请求就会接受审核。 |
模型排名无法让通配符配置排在语言区域匹配度更高的配置之前。术语表的添加顺序也不决定优先级。如果已保存的配置中有预期内容,请求却选择了其他内容,请留意这些区别。
排查地区或文字体系不匹配的问题 #
为一个地区保存的指导内容未在另一个地区生效 #
假设术语表中的西班牙语术语保存在 es-419 下,而请求的目标是 es 或 es-MX。这两个请求都不会使用这些术语:es 代表西班牙,而 es-419 仅适用于 es-419 请求。请将面向所有西班牙语受众的通用术语保存到 es,或为请求涉及的每个地区分别保存。葡萄牙语也是如此:pt 代表巴西,因此保存在 pt-PT 下的术语仅适用于 pt-PT 请求。
品牌语调指定了地区,但请求未指定地区 #
假设某个品牌语调有 de-DE 和 de-CH 两个变体,而请求的目标是 de。请求会使用 de-DE 变体,因为 de 代表德国使用的德语。de-CH 变体仅适用于 de-CH 请求。对于面向瑞士的内容,请将请求的目标设为 de-CH,而不要期望本地化引擎根据源内容推断受众。
地区规则与宽泛规则相互矛盾 #
要求使用正式称呼的通配符规则,以及要求使用非正式称呼的适用地区规则,都可能被纳入提示词。更具体的规则并不会取消宽泛的要求。请消除冲突,或缩小冲突规则的适用范围,让选中的指令指向一致的预期行为。
首选术语使用了不同的文字体系 #
只有当自定义译文的源语言区域和目标语言区域所对应的文字体系分别与请求一致时,该译文才适用。每个语言区域的文字体系由 CLDR 默认值确定:zh、zh-CN 和 zh-SG 对应简体,zh-TW 和 zh-HK 对应繁体,sr 对应西里尔字母,sr-ME 对应拉丁字母。
因此,保存在 zh 下的术语适用于 zh、zh-CN 和 zh-SG 请求,但绝不适用于 zh-TW 请求,即使保存在 zh 下的规则和品牌语调适用于 zh-TW。保存在 zh-Hans 下的术语适用于 zh 请求,保存在 zh-TW 下的术语适用于 zh-Hant 请求。请将台湾和香港共用的繁体术语保存到 zh-Hant。不可翻译的名称不受此限制,因为它会保持原样。
自定义译文面向所有语言 #
目标为 * 的自定义译文,其目标文本必须与源文本相同。要设置首选译文,请使用具体的目标语言区域;对于在所有语言中都必须保持不变的文本,请使用不可翻译条目。
添加语言区域时逐项检查 #
语言配置本身不会实现从右到左的布局,也不会让应用根据语言区域调整格式。检查译文时,请同时检查界面的实际显示效果。有效的样例只能确认对应场景下的行为,不能代表新增语言区域的整体质量。