收集译文以进行测量
选择受支持的数据源,保留测量所需的文本、修订版本和上下文。
测量可以从团队现有的译文入手。继续在代码仓库或翻译管理系统中维护已采纳的文本,再选择如何将这些文本提供给检查流程。
测量应以可明确识别的版本为基本单位。如果一条消息在评估后发生变化,先前的结果仍只对应先前的措辞。将源文和译文的修订版本一并保留,团队就能回查原始依据,而不必根据最新内容重新还原。
为工作流选择数据源 #
| 起点 | 测量方式 |
|---|---|
| Crowdin 活动 | 连接 Crowdin,配置事件测量,再查看生成的 Radar 事件及测量结果。查看 Radar 页面需要相应的访问权限。 |
| GitHub 提交 | 连接 GitHub App,并配置源文和译文路径。默认分支上受支持的本地化键发生变化时,就会生成事件。 |
| Zendesk 帮助中心 | 连接 Zendesk。已发布文章发生变化时,会生成相应语言的源文或译文事件。 |
| 本地翻译文件 | 配置评分器和模型后,使用 lingo score。结果会写入本地,不会进入 Radar 事件历史记录。 |
| Lingo.dev 翻译 | 每次完成本地化时,都已生成对应事件。审核 Lingo.dev 翻译介绍了如何选择引擎、语言和样本。 |
如需使用其他数据源,请先联系 Lingo.dev 安排事件收集,再将交付流程自动化。
收集 GitHub 和 Zendesk 活动 #
对于 GitHub,请为目标仓库安装 GitHub App,并将其连接到 Lingo.dev 组织。提交 .lingo/config.json,其中需包含源语言区域、目标语言区域和源文件匹配模式。这些路径用于区分源文变更和译文变更。默认分支上的提交更改已配置的本地化键后,请查看生成的事件;一次提交可能会为多个键和多种语言生成事件。
GitHub 活动收集支持读取 JSON、JSONC、YAML、带根键的 YAML、Android 资源、Apple .strings、Flutter ARB、PHP 和 TypeScript 文件。仓库变更介绍了变更如何转化为事件。
对于 Zendesk,请授权帮助中心连接,并启用其支持的语言。Radar 会按语言记录已发布文章的活动。打开事件,将其中的文章标识、语言区域和文本与 Zendesk 中的内容进行核对。收集活动本身不会触发翻译同步,也不会发布新的目标语言文章。
这两种连接都会将已采纳的译文保留在原系统中。测量仅检查已记录的事件,不承担发布操作。
先导入服务提供方的历史记录,再进行测量 #
选择所需的服务提供方历史记录:
- GitHub:导入仓库默认分支上最近的最多 5,000 次提交。读取每次提交时,都会使用该修订版本中保存的
.lingo/config.json。创建该配置之前的提交不会生成事件。 - Zendesk:导入各语言现有文章、分区和分类当前已发布的版本,并以其最后更新时间作为日期。较早的修订版本和草稿版本不在收集范围内。
新建 GitHub 和 Zendesk 连接后,系统会自动开始导入历史记录。可在连接的设置选项卡中查看进度。如需稍后启动或重试导入:
- 在 Studio 的已连接下选择仓库或帮助中心,然后打开其设置选项卡。
- 在 GitHub 的提交历史记录或 Zendesk 的帮助中心历史记录下,选择导入历史记录。
- 查看导入进度,其中会统计服务提供方已排队等待收集的条目数量。
- 等待需要测量的事件出现在 Radar → 日志中,再核查其日期、语言区域和文本。
对于基于服务提供方事件运行的测量,其回填选项卡也提供导入事件功能,可选择已连接的 GitHub 仓库和 Zendesk 帮助中心。导入历史记录时只收集事件,不运行测量。所需事件出现后,启用测量,并针对这些事件所在的时间区间启动历史评估。
如果回填后又出现更多导入的事件,请启用仅限尚未测量的事件,然后再次运行回填。如果导入失败,请查看进度,并在同一个设置选项卡中重试。请将测量的回填及结果与导入过程分开检查。
保留比较依据 #
将源系统 ID、内容 ID、目标语言区域和译文修订版本一并保留。进行语义检查时,还需添加对应的源文修订版本。进行编辑测量时,请保留编辑后译文所依据的草稿。
例如,在你自己的跟踪记录中,delivery.promise、语言区域 fr 和修订版本 42 的组合可以确定某个具体的目录条目。修订版本 43 可能会改变其中的承诺。
如果工作流提供了译文的生成来源,请将其记录下来:人工、模型、机器翻译服务提供方,或翻译记忆复用。来源未知时,应保留为未知。服务提供方系统中批准译文的用户,不一定就是撰写译文的人或模型。
为选定的检查问题提供依据 #
检查标准决定了需要收集的内容。拼写检查只需查看译文。语义检查需要配对的源文和译文,以及用于消除歧义的上下文。术语检查需要适用的术语及其使用范围。占位符检查需要预期的占位符约定,而编辑距离则需要实际配对的草稿和译文。
如果某条译文缺少源文修订版本,请在语义检查中将其保留为未评估案例,待获取源文后再作判断。
验证一个已收集的事件 #
- 先配置选定的测量,再在已连接的数据源中产生测试活动。
- 找到对应的事件,将其语言区域、文本、来源及可用草稿与你自己的记录进行核对。
- 打开测量结果,对照文本阅读检查标准。确认测量是返回了结果、返回了 N/A,还是未能完成。
- 将事件和测量的标识与已评估的修订版本一并保留。任何已采纳的修正,都应在负责维护文本的系统中落实。
对于本地评分,请结合输入文件和评分器配置查看已保存的结果;这种方式不会创建 Radar 事件。
对于重复运行的工作流,请保留所选、所收集和所测量的内容。测量流水线中的译文介绍了收集和恢复流程,包括重试及修订版本变更的处理。