Sphinx 是创建优美文档的工具。它使用了简单的 reStructuredText 语法,并以多种格式输出。如果要找个示例,那么本文档也是用它来构建的。我不会聚焦在撰写文档本身,如果您需要指导的话,只需要按照 Sphinx 网站上的指示即可。一旦准备好文档,将其翻译是非常容易地,因为 Sphinx 带有对此的支持,并且在其 Internationalization 中覆盖得很好。这只不过是一些配置指令并调用 sphinx-intl 工具的事。

它们的 Localization of Documentation 几乎覆盖了您需要的每一件事——创建另一个项目,设置其语言以及从主项目上炼接它作为翻译。

使用这种方法可以发现正在翻译的几个文档项目: