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

Question

我正在开始一个个人项目，我想为我的法语研究员以及说英语的其他人提供文档。

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

要分离什么（我猜来源，一些配置项，如生成导航链接的语言......）？

什么不分开（最多配置项避免重复）？

Answer 1

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

    |-- 来源
    |-- 构建
    | `-- html
    | `-- 乳胶
    |-- i18n
    | `--fr
    | |-- 来源
    | |-- 构建
    | | `-- html
    | | `-- 乳胶

基本上，i18n/<lang>/下的子目录反映了经典的 Sphinx 目录结构。

我们文档中的如何以您的语言翻译开放对象文档页面解释了该过程。

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