CLI v0 参考
维护已安装的 i18n.json 项目,同时保留已采纳的译文和源内容基线。
本手册介绍旧版 lingo.dev 软件包及其 i18n.json/i18n.lock 工作流,示例均以 0.138.10 为准。规划迁移期间,请沿用现有项目 Lockfile 中记录的版本。安装随时会变动的最新版本,无法以可复现的方式恢复项目。
新项目请直接使用当前版本的 CLI。它采用服务端推送/拉取工作流,状态和选择规则都有所不同。
已安装的 v0 如何运行 #
存储桶配置负责选择解析器、查找源文件和目标文件,并在需要时展开 [locale]。解析器会提取内容,并单独分离出识别到的不可翻译值。差异比对会对照源值、现有目标值和先前的源内容校验和,找出新增、修改、删除或重命名的条目。
选中的文本会交给 Lingo.dev 本地化引擎或已配置的直连服务提供商处理。返回的译文随后会重建为目标文件,或写入共享文件中对应的语言区域部分。某个任务可能在另一个任务失败前就已写入成功的输出,因为整个项目并不是一个原子事务。
让基线与内容一同保存 #
请将 i18n.json、已采纳的语言区域输出和 i18n.lock 一并提交。Lockfile 记录的是源内容状态,不会记录每一次目标内容编辑或语言审批。常规运行会推进源内容校验和;限定目标语言区域或键的运行则可能只写入输出,不刷新现有基线。
Lockfile 参考说明了为什么在限定范围的运行之后,后续的常规处理仍可能重新处理某项源内容变更。现有译文介绍了如何在不替换全部已有值的前提下接入现有译文。
确定下一步操作 #
按照首个文件操作流程复现一次小规模的旧版运行。配置和格式说明了当前安装的这一代版本会读取和写入哪些内容。
日常维护中,语言区域介绍如何添加目标语言区域;键控制用于区分常规编辑与人工维护的值;重新翻译用于限定有意刷新的范围。单体仓库和并行处理讲解归属管理与吞吐量,但并不假定增加工作进程就能突破服务提供商的限制。