添加语言

更新时间:上季度 · 预计阅读 1 分钟

添加一种语言分两步:先把它加入目标语言列表,再执行补齐。

1. 在配置中添加语言#

编辑 .lingo/config.json 中的 targetLocales:

json
{
  "sourceLocale": "en",
  "targetLocales": ["de", "fr", "es", "ja"]
}

这里新增的是 ja。任何 BCP 47 code 都可以。

2. 补齐新语言#

bash
lingo push --backfill-missing

--backfill-missing 会为所有尚不存在的目标语言生成翻译,覆盖所有已配置的模式。现有的 de、fr 和 es 文件已存在,因此会被跳过——只会生成新的 ja 文件。

text
✓ Run lfr_a8c...: localized 14 target file(s), 0 already up-to-date.

为什么不能直接 push?

单独执行 lingo push 时,只会检查自上次运行以来哈希发生变化的源文件。新增语言不会改动任何源文件,所以直接 push 不会找到任何需要处理的内容。而 --backfill-missing 判断的依据是缺失的目标文件,这正是新增语言时会出现的情况。

先估算#

如果想在实际花费前先看看新增语言的成本:

bash
lingo push --backfill-missing --estimate

会输出预估费用并直接退出,不执行翻译。有关 --estimate 和 --force 的更多说明,请参阅 Retranslation。

移除语言#

先将它从 targetLocales 中移除,再删除对应文件:

bash
lingo purge --locale ja

请参阅 Purge。