添加和管理 CLI v0 语言区域
选择所需的语言变体,添加旧版目标语言区域,并验证相关文件和应用的行为。
在 v0 中,locale.source 指定原始语言,locale.targets 则指定后续翻译使用的目标语言区域。选择读者所需的语言变体后,请检查配置、文件名、后端和应用是否都使用了同一变体。
添加一个目标语言区域 #
要在已有西班牙语和法语的基础上添加德语,请编辑 i18n.json:
{
"locale": { "source": "en", "targets": ["es", "fr", "de"] }
}针对该目标语言区域运行已安装的 v0 二进制程序:
lingo run --target-locale de该标志会覆盖本次运行的目标列表,也可用于选择配置中未列出的语言区域。如需在后续运行中继续使用,请将其添加到配置中。独立文件模式 locales/[locale].json 会写入 locales/de.json;向读者开放德语前,请检查文件中的值,并在应用中加载该文件。
尚不存在的目标需要翻译所有选定的键。已有目标通常会保留现有值,并补齐缺失的键,但源内容发生变化时,仍可能需要重新翻译。如果其他已接受的语言区域需要保持不变,请避免在首次添加语言时同时进行大范围强制重译。
将本次运行限定在某个目标语言区域内,并不会更新现有的源内容校验和基线。后续常规运行仍可能重新处理已更改的源内容,因此,在认定限定范围的审核已彻底处理这些变更之前,请先遵循收尾规则。
按需区分地区和文字体系 #
{
"locale": {
"source": "en-US",
"targets": ["en-GB", "es-MX", "pt-BR", "fr-CA"]
}
}带地区标识的语言区域可区分所需的语言惯例:英语中的 color/colour、西班牙语中的 ordenador/computadora,以及葡萄牙语中的 trem/comboio,都说明仅指定语言可能还不够。具体用法仍取决于上下文;语言标签并不能保证生成的每个表达都适合受众。中文也可能需要区分文字体系或地区,例如 zh-Hans 或 zh-TW。
查看已安装版本对应的列表:
lingo show locale sources
lingo show locale targets这些列表并不保证每个后端都能接受相应语言或提供理想的翻译质量。扩大使用范围前,请先进行一次小规模运行,验证选定的语言对,而不要仅凭过去支持的语言数量作判断。
将语言标识与文件布局分开处理 #
旧版处理逻辑会在 API 请求中统一若干平台特有的写法。但文件仍可能需要使用下划线或 Android 资源命名方式。请使用分隔符设置和该格式的布局,然后检查实际输出位置。
翻译不会设置 dir、镜像翻转控件或添加路由。阿拉伯语、希伯来语、波斯语和乌尔都语通常需要从右到左(RTL)显示;请检查使用这些内容的界面,包括其中嵌入的数字和标识符。应用不仅要加载新语言区域的内容,还必须能识别该语言区域。
移除目标语言区域 #
从 locale.targets 中移除某个代码后,后续运行将不再选择它,但现有文件仍会保留。请另行决定是保留这些文件、停止提供它们,还是将其删除。清除操作具有破坏性,也可能选中源内容;它与移除已配置的语言区域是不同的操作。