CLI v0 Lockfile
通过旧版源内容基线了解待处理变更并恢复状态,避免掩盖尚未完成的翻译。
i18n.lock 帮助 v0 区分未变更的源内容与需要翻译的文本。请将它与所记录的源内容及已接受的目标译文一同保存。它不会记录对目标译文的每一次人工修改,也不能证明翻译正确。
文件记录了什么 #
在 lingo.dev@0.138.10 中,该文件采用 YAML 格式,包含 version: 1 和一个 checksums 映射。每个外层分区都对处理过的路径模式进行哈希计算;其中的条目将源键映射到基于 MD5 的源值校验和。请交由 CLI 管理这些条目,不要手动创建。
校验和发生变化后,现有键便可纳入翻译范围。匹配的源值哈希还可以将同一处理上下文中的新键与已移除的键关联起来,以便在键重命名时复用译文。这两种机制都不等同于可无限制跨文件使用的翻译记忆。
区分翻译与基线替换 #
| 操作 | 作用 |
|---|---|
lingo run | 翻译计算出的变更部分,并更新源内容状态。 |
lingo run --force | 不依赖常规变更差异,重新生成选定的输出。 |
lingo lockfile | 添加缺失的源内容状态分区,不改动已有内容的分区。 |
lingo lockfile --force | 根据当前文件替换源内容校验和,不翻译目标内容。 |
lingo run --frozen | 检查同步状态,不进行翻译;但若基线缺失,会先将其初始化。 |
假设法语译文被接受后,英语源内容发生了变化。使用 lockfile --force 替换其校验和,会将新的英语源内容记录为基线,而法语译文可能仍在表达旧的含义。因此,不应将重建作为消除同步失败的常规手段。
针对特定目标语言区域或特定键的运行可以写入译文,而不更新现有的共享源内容基线。之后的常规运行可能再次处理这项源内容变更,覆盖在那次限定范围运行之后做出的修正。更新共享基线前,请仔细核对并协调相关语言区域的输出。
在多个语言区域中完成同一项源内容变更的处理时:
- 保持源内容版本不变;只要还有受影响的输出尚未完成,就保留
i18n.lock。使用lingo run进行常规的全项目更新;如果各项输出需要分别处理和审核,则使用文档中介绍的 限定范围运行。 - 检查源内容校验和替换所涵盖的每个语言区域输出,包括最近一次限定范围运行未涉及的输出。解决失败问题,并对照该源内容核对、协调已接受的人工修正。如果任何输出仍未更新或存在疑问,请暂不更新共享基线。
- 如果限定范围的处理未改变现有基线,且所涵盖的输出均已被接受,请在预期的项目根目录下运行
lingo lockfile --force。它会替换源内容校验和,但不会进行翻译,因此不要用它跳过前面的审核,也不要假定上一次使用的目标语言区域选择器会限制此次替换的范围。 - 检查 Lockfile 的差异,并将确切的源内容版本、所有对应的已接受目标译文以及
i18n.lock一同提交。之后可使用lingo run --frozen检查与这份已确定基线的同步状态;它无法确认目标译文是否为最新,也无法验证翻译质量。
当 i18n.lock 不存在时,冻结模式并非严格只读。它可能先初始化校验和,而仅凭目标键已存在,并不能证明译文是最新的。在将冻结检查通过视为同步证据之前,请先确认源内容与目标译文的配对可信。
恢复缺失或存在冲突的状态 #
当 Lockfile 缺失时,v0 不一定会重新生成所有现有目标译文:没有先前的校验和时,它可能保留这些值。接受新创建的基线前,请检查存在疑问的源内容与目标译文配对。现有译文介绍了这种接纳已有译文的情况。
遇到合并冲突时,请先核对并协调两个分支中的源内容和目标译文变更,并尽可能恢复可信的 Lockfile。如果必须重建,请审核实际的源内容与译文配对,因为重建记录的是源内容状态,而不能说明目标译文是否为最新。
旧版 YAML 修复流程会保留重复条目中的最后一项,并报告移除情况。这只能解决条目重复的语法问题,无法判断哪个分支的措辞正确。在将修复后的文件与已接受的输出一同提交前,请检查存在冲突的值。