internationalization - 如何维护用 Sphinx 编写的文档集的多个翻译版本？

Question

我正在开始一个个人项目，我想为讲法语的同事以及讲英语的其他人提供文档。

那么我应该如何组织我的目录呢？

要分开什么(我猜来源，一些 conf 项目，比如生成的导航链接的语言......)？

什么不分开(最大配置项避免重复)？

Answer 1

我们创建了一个 Python 脚本来管理文档的翻译工作。它创建一个如下所示的目录结构:

    |-- source
    |-- build
    |   `-- html
    |   `-- latex
    |-- i18n
    |   `-- fr
    |       |-- source
    |       |-- build
    |       |   `-- html
    |       |   `-- latex

基本上，i18n// 下的子目录是经典 Sphinx 目录结构的镜像。

How to translate the Open Object Documentation in your language我们文档中的页面解释了该过程。

文档托管在 Launchpad 上:https://launchpad.net/openobject-doc