在 CLI v0 中接入现有翻译
补齐旧版翻译目录中缺失的键,保留现有值,并建立可靠的源内容基线。
V0 可以直接处理由其他工具生成的翻译目录。常规增量处理会对比源目录与目标目录的键,补齐缺失条目,而不重新生成现有值。这与当前 CLI 补齐缺失文件的机制不同。
保留现有成果 #
在 i18n.json 中配置翻译目录的桶,并为已确认的目标翻译保存一份可恢复的副本。请确认现有值是真正的译文:源语言占位文本可能会掩盖你原本想补齐的缺漏。
例如,这份源内容包含三个键:
json
{
"welcome": "Welcome back",
"button.save": "Save",
"button.cancel": "Cancel"
}现有的西班牙语目标翻译包含两个键:
json
{
"welcome": "Te damos la bienvenida de nuevo",
"button.save": "Guardar"
}常规补齐任务会添加 button.cancel,并保留现有值;但如果之前的校验和表明源内容已发生变化,需要重新翻译,则会重新生成相应的值。
先针对一个语言区域运行,再检查差异 #
sh
lingo run --target-locale es检查新增条目、源内容中已不存在的键是否被删除,以及内容发生变化的键所对应的重新生成值。确认译文语言正确、应用加载正常后,将已确认的输出与 Lockfile 状态一并提交。
限定范围的运行不会更新现有的源内容校验和基线。Lockfile 未发生变化,并不代表所有语言区域都与当前源内容一致。后续的常规运行可能会重新处理已变更的源文本;请参照基线确立。
如果某个现有键没有先前的校验和,0.138.10 不会仅因校验和缺失就将该键标记为已更新。因此,缺少 Lockfile 不会强制重新翻译全部内容,也不能证明现有目标翻译已是最新状态。在将新基线作为权威依据之前,请检查有疑问的源文与译文配对。
单独修正已知问题 #
如果现有值不正确,可以进行手动修正,或请求刷新选定内容:
sh
lingo run --force --target-locale es --key button.cancel强制操作可能会覆盖手动修改。如果某个值必须由人工掌控,请使用保留键,并将后续源内容变更的审核也纳入这项管理职责。