治理
leji.org 如何翻译
AI 智能体辅助翻译。如有出入,以英文页面为准。如果你发现文本有任何问题,欢迎提交议题或发起拉取请求。
leji.org 以英文书写,再逐一翻译成各种语言。本页记录两个版本出现出入时以哪一份为准、一份翻译如何完成、它的术语参照哪些资料,以及如何报告错误。
以英文页面为准
每个页面都先用英文写成。翻译页面是对该英文页面的翻译,并在标题下方写明这一点;两者出现出入时,以英文文本为准。规范的译文属于资料性译文:规范性文本是冻结的 1.0 版本系列上的英文原文,每个翻译后的规范页面都带有说明此事的横幅。
一份翻译如何完成
页面先以智能体辅助的工作流起草,再逐页批准后才会发布。两个未参与起草的独立评审引擎会分别核对与英文的忠实程度、术语是否符合该语言的术语表,以及行文是否流畅;只有两者都认可,页面才会发布。
术语
每种语言都维护一份 Leji 所用术语的术语表。若某个术语在某个知名开源项目的人工翻译中已有约定俗成的译法,术语表会沿用它,或记录一个有理由的例外。这些参照只是辅助,绝不是来源。下面的清单会随着这些项目译本的出现与消失而保持更新。
简体中文
- MDN Web Docs (zh-CN)
- Kubernetes 文档(zh-cn)
- Pro Git (zh)
- GitHub Docs (zh)
- Python 3 文档(zh-cn)
- Vue.js (zh)
- Vite (zh)
- React (zh-hans)
- TypeScript (zh)
- Keep a Changelog (zh-CN)
- Semantic Versioning (zh-CN)
- Hugging Face Agents Course (zh-CN)
日语
- Pro Git (ja)
- GitHub Docs (ja)
- Kubernetes 文档与术语表(ja)
- MDN Web Docs (ja)
- React (ja)
- Vue (ja)
- Python 文档(ja)
- Python Packaging User Guide (ja)
- WCAG 2.1 (ja, WAIC)
- W3C 规范通用内容(ja)
- W3C (ja)
- Keep a Changelog (ja)
- Semantic Versioning (ja)
- Vite (ja)
- Rails Guides (ja)
- OpenStack Security Guide (ja)
巴西葡萄牙语
- Pro Git (pt-br)
- GitHub Docs (pt)
- Kubernetes 文档(pt-br)
- Python 文档(pt-br)
- MDN Web Docs (pt-BR)
- W3C WCAG 2.0 授权译本(pt-br)
- Django 文档(pt-br)
- React 文档(pt-br)
- Astro 文档(pt-br)
- Keep a Changelog (pt-BR)
- TypeScript 站点(pt)
- Vue 文档(pt)
西班牙语
- Pro Git (es)
- Git 的西班牙语本地化翻译(po/es.po)
- Kubernetes 文档与术语表(es)
- MDN Web Docs (es)
- Python 文档(es)
- React 文档(es)
- Keep a Changelog (es)
- Semantic Versioning (es)
- Conventional Commits (es)
- Open Source Guides (es)
- GitHub Docs (es)
- Astro 文档(es)
越南语
- Git 的越南语本地化翻译(po/vi.po)
- Kubernetes 文档与术语表(vi)
- Semantic Versioning 2.0.0 (vi)
- Vue.js 文档(vi,Vue 2)
- The Twelve-Factor App (vi)
- Contributor Covenant 2.1 (vi)
- GNOME GTK 本地化翻译(po/vi.po)
- 越南国家标准草案(标准文件用语)
- 越南语维基百科(次要参考)
保持与英文同步
每个翻译页面都记录它所依据的英文源文件修订版本。每次构建时都有一项检查,只要有译文落后于它的来源,就让这次构建失败,因此已发布的译文绝不会比它所翻译的英文更旧。这个修订版本只做记录,不会显示出来。
报告错误
每个翻译页面在标题下方都带有两个链接:一个用于新建议题,语言与页面已经预先填好;另一个打开该页面自身的源文件,用于发起拉取请求。单页规范视图是个例外:它由多份文档合成,而不是只有一份,因此它的议题链接位于页面顶部的横幅中,每个文档标题旁各有一个编辑链接。更正会像其他任何改动一样经过评审,并随下一次发布落地。
哪些内容不翻译
命令名、标志、路径、JSON 键与代码示例保持英文;代码示例中的注释会翻译。JSON Schema 文件本身与原始 markdown 路由保持英文。