治理

leji.org 如何翻译

AI 智能体辅助翻译。如有出入,以英文页面为准。如果你发现文本有任何问题,欢迎提交议题或发起拉取请求

leji.org 以英文书写,再逐一翻译成各种语言。本页记录两个版本出现出入时以哪一份为准、一份翻译如何完成、它的术语参照哪些资料,以及如何报告错误。

以英文页面为准

每个页面都先用英文写成。翻译页面是对该英文页面的翻译,并在标题下方写明这一点;两者出现出入时,以英文文本为准。规范的译文属于资料性译文:规范性文本是冻结的 1.0 版本系列上的英文原文,每个翻译后的规范页面都带有说明此事的横幅。

一份翻译如何完成

页面先以智能体辅助的工作流起草,再逐页批准后才会发布。两个未参与起草的独立评审引擎会分别核对与英文的忠实程度、术语是否符合该语言的术语表,以及行文是否流畅;只有两者都认可,页面才会发布。

术语

每种语言都维护一份 Leji 所用术语的术语表。若某个术语在某个知名开源项目的人工翻译中已有约定俗成的译法,术语表会沿用它,或记录一个有理由的例外。这些参照只是辅助,绝不是来源。下面的清单会随着这些项目译本的出现与消失而保持更新。

简体中文

日语

巴西葡萄牙语

西班牙语

越南语

保持与英文同步

每个翻译页面都记录它所依据的英文源文件修订版本。每次构建时都有一项检查,只要有译文落后于它的来源,就让这次构建失败,因此已发布的译文绝不会比它所翻译的英文更旧。这个修订版本只做记录,不会显示出来。

报告错误

每个翻译页面在标题下方都带有两个链接:一个用于新建议题,语言与页面已经预先填好;另一个打开该页面自身的源文件,用于发起拉取请求。单页规范视图是个例外:它由多份文档合成,而不是只有一份,因此它的议题链接位于页面顶部的横幅中,每个文档标题旁各有一个编辑链接。更正会像其他任何改动一样经过评审,并随下一次发布落地。

哪些内容不翻译

命令名、标志、路径、JSON 键与代码示例保持英文;代码示例中的注释会翻译。JSON Schema 文件本身与原始 markdown 路由保持英文。