更新时保留已审核的翻译
一并保留源文和已接受的目标译文基线,选择合适的更新模式,并核实每一处改动。
已接受的翻译是值得保留的工作成果。一条源文消息发生变化,并不意味着相邻消息的译文也需要修改。只要工作流获得正确的基线,并按预期方式合并,就能通过复用保留这些译文。
仅用“增量”一词,并不足以说明这种保护机制。请保留之前的源文和已接受的目标译文,选择调用方的更新约定,并检查实际差异。如果已明确需要修正某条目标译文,请使用单键更新;如果已提交的工作中途停止,请先从恢复入手。
记录哪些内容必须修改,哪些内容必须保留 #
以下面的源文为例:
{
"retention": "Reports remain available for 30 days.",
"support": "Contact support",
"productName": "ExampleApp"
}源文负责人将保留期限改为 60 天。请保留旧源文、新源文和已审核的目标译文。目标译文中的期限必须修改,但已接受的 support 措辞应保持不变。让 productName 与源文完全一致,与保留已审核的目标译文措辞,是两种不同的要求。
请保存最新的已接受目标译文版本,包括下载后在本地所做的修改及修改理由。服务器上的基线与工作树中的目标译文,可能已不再是同一份内容。
源文变更采用常规增量规划 #
当前 CLI 的常规 lingo push --wait 会根据已记录的源文状态和目标译文规划变更。请将配置、源文、已接受的目标译文和 .lingo/lock.json 一并纳入版本控制。删除 Lockfile 会影响变更规划,并不是一次不影响结果的刷新。
--backfill-missing 会补齐缺失的目标文件,但不会逐一补齐现有文件中缺失或已更改的键。通过位置参数指定的源文模式会采用限定范围的规划,复用方式也有所不同。--force 会重新生成所选的独立目标文件,并可能替换已接受的文本;共享的 XCStrings 目录仍可复用其中嵌入的翻译。请求替换前,请查阅推送参考,选择合适的方式。
大范围执行前,请先检查作用范围,并在有必要时进行估算。获取结果后,请对比已更改的值及其附近已接受的值。内容是否得到保留,应以实际结果为准,而不是根据运行标签判断。
区分源文锁定与目标译文保留 #
在支持此功能的格式中,锁定的键会将源文文本复制到目标译文中,保留的键则会保留现有目标值。因此,锁定一条已审核的法语消息,可能会将其替换为英语,并不能保护原有的法语措辞。
键控制因格式而异。从输出中排除某个键,则是另一种操作。如果某个值对应的源文事实已发生变化,就不应无条件保留该值,否则可能留下过时的含义。
获取结果时核对并处理本地修正 #
提交更新前,请保存已有修正。推送时捕获的那份目标译文,可能在本次更新中被替换。要检测提交后的修改,请省略 --wait,然后检查 lingo pull --dry-run。拉取操作会将本地目标译文与捕获的目标译文及已记录的哈希值进行比较,并可能拒绝覆盖后续修改;从 push --wait 直接下载则不会重新检查当前状态。
遇到冲突时,请结合相关源文版本,对比本地修正、已记录的目标译文和传入结果。仍然适用的修正,应通过正常审核流程予以保留。只有在保存本地工作并明确决定替换后,才使用 lingo pull --force。强制操作只会绕过保护机制,不会替你选出正确的语言表达。
对于共享的 Apple 目录,请保留整个文件,并检查未修改的语言区域。不要将同时包含源文和多种语言的文件视为可随意丢弃的目标输出而清除。
检查后接受新基线 #
在本例中,请确认新目标译文中的期限为 60 天、support 值已保留,且 productName 的行为符合预期。请在使用这些内容的运行时中检查变量和结构。差异对比用于找出改动;语言审核则用于判断新的表述是否正确。
将已接受的目标译文及其对应的源文版本保存为下一次的基线。如果这项修正需要改变今后的指导原则,请另行决定如何调整术语表或规则,不要假定接受一次修改就能让本地化引擎学会新策略。