跳到内容
DispatchAtlas
搜索

翻译

DispatchAtlas 如何本地化其文档:语言队列、当前覆盖、机器-种子加人工-评审流水线,以及如何贡献一份翻译。

DispatchAtlas 以一个由十二个语言组成的队列提供其文档。英语是源;其余每个语言皆为翻译目标。 本页声明今日所翻译的内容、统辖翻译质量的纪律,以及贡献一份翻译的步骤。

语言队列

站点注册十二个语言——英语位于站点根,外加十一个带前缀的翻译目标:

语言代码方向
英语(源)en从左到右
普通话(简体)zh-cn从左到右
西班牙语es从左到右
葡萄牙语(巴西)pt-br从左到右
法语fr从左到右
德语de从左到右
日语ja从左到右
韩语ko从左到右
俄语ru从左到右
印尼语id从左到右
阿拉伯语ar从右到左
印地语hi从左到右

每个页面声明其 lang,阿拉伯语另外从右到左渲染,且一个对称的 hreflang 集合外加一个指向 英语页面的 x-default 为搜索引擎连接该队列。一个尚未翻译某给定页面的语言会省略该页面的 hreflang 条目,而非将其指向英语,从而准确报告其缺失。

当前覆盖

界面外壳——导航、控件、搜索与页脚——已在全部十二个语言翻译。文档页面以增量方式翻译;在所请求 语言中无翻译的页面会渲染英语源作为回退,从而任何路由都不会损坏。覆盖在下述评审流水线之下 逐页增长;语言切换器始终至少以英语形式抵达每个页面。

机器-种子加人工-评审流水线

翻译质量是发布标准,而非事后补救。两个阶段统辖每个被翻译的页面:

  1. 机器种子。 一个页面首先由机器翻译针对按-语言词汇表起草,该词汇表将领域词汇(调度、 dispatch、基准、求解器、目标、约束)固定为每个语言一个一致的术语。
  2. 人工评审。 一位母语-流利的评审者在其发布之前,针对流畅度、术语与语气校正种子。带 机器-种子的文案绝不作为最终未评审文本发布。

一个页面在某语言中仅在一位评审者已为其作证之后才算发布就绪。在此之前英语回退成立,它是准确 且完整的,而非部分-翻译的。

贡献一份翻译

  1. site/content/docs/en/ 下选择一个页面与目标语言。
  2. site/content/docs/<locale>/ 下以相同的相对 slug 与相同的 frontmatter 键 (titledescription)创建镜像路径。
  3. 翻译正文,尊崇该语言的词汇表,使领域术语与该语言的其余部分保持一致。
  4. 使每个代码块、命令、标识符、链接目标与图形引用与源相同——仅自然语言散文被翻译。
  5. 开启一份贡献以供母语-流利评审。一旦作证,该页面便以该语言发布,且其 hreflang 条目被 加入队列。

参见贡献指南了解仓库工作流以及适用于每次更改的评审流程。