翻译
DispatchAtlas 如何本地化其文档:语言队列、当前覆盖、机器-种子加人工-评审流水线,以及如何贡献一份翻译。
DispatchAtlas 以一个由十二个语言组成的队列提供其文档。英语是源;其余每个语言皆为翻译目标。 本页声明今日所翻译的内容、统辖翻译质量的纪律,以及贡献一份翻译的步骤。
语言队列
站点注册十二个语言——英语位于站点根,外加十一个带前缀的翻译目标:
| 语言 | 代码 | 方向 |
|---|---|---|
| 英语(源) | en | 从左到右 |
| 普通话(简体) | zh-cn | 从左到右 |
| 西班牙语 | es | 从左到右 |
| 葡萄牙语(巴西) | pt-br | 从左到右 |
| 法语 | fr | 从左到右 |
| 德语 | de | 从左到右 |
| 日语 | ja | 从左到右 |
| 韩语 | ko | 从左到右 |
| 俄语 | ru | 从左到右 |
| 印尼语 | id | 从左到右 |
| 阿拉伯语 | ar | 从右到左 |
| 印地语 | hi | 从左到右 |
每个页面声明其 lang,阿拉伯语另外从右到左渲染,且一个对称的 hreflang 集合外加一个指向
英语页面的 x-default 为搜索引擎连接该队列。一个尚未翻译某给定页面的语言会省略该页面的
hreflang 条目,而非将其指向英语,从而准确报告其缺失。
当前覆盖
界面外壳——导航、控件、搜索与页脚——已在全部十二个语言翻译。文档页面以增量方式翻译;在所请求 语言中无翻译的页面会渲染英语源作为回退,从而任何路由都不会损坏。覆盖在下述评审流水线之下 逐页增长;语言切换器始终至少以英语形式抵达每个页面。
机器-种子加人工-评审流水线
翻译质量是发布标准,而非事后补救。两个阶段统辖每个被翻译的页面:
- 机器种子。 一个页面首先由机器翻译针对按-语言词汇表起草,该词汇表将领域词汇(调度、 dispatch、基准、求解器、目标、约束)固定为每个语言一个一致的术语。
- 人工评审。 一位母语-流利的评审者在其发布之前,针对流畅度、术语与语气校正种子。带 机器-种子的文案绝不作为最终未评审文本发布。
一个页面在某语言中仅在一位评审者已为其作证之后才算发布就绪。在此之前英语回退成立,它是准确 且完整的,而非部分-翻译的。
贡献一份翻译
- 在
site/content/docs/en/下选择一个页面与目标语言。 - 在
site/content/docs/<locale>/下以相同的相对 slug 与相同的 frontmatter 键 (title、description)创建镜像路径。 - 翻译正文,尊崇该语言的词汇表,使领域术语与该语言的其余部分保持一致。
- 使每个代码块、命令、标识符、链接目标与图形引用与源相同——仅自然语言散文被翻译。
- 开启一份贡献以供母语-流利评审。一旦作证,该页面便以该语言发布,且其
hreflang条目被 加入队列。
参见贡献指南了解仓库工作流以及适用于每次更改的评审流程。