sphinx 可以鏈接到不在根文檔下的目錄中的文檔嗎?

| | | | | | | | | | | | | |

我正在使用 Sphinx 來記錄一個非 Python 項目。我想在每個子模塊中分發 ./doc 文件夾,其中包含 submodule_name.rst 文件以記錄該模塊。然後,我想將這些文件吸入主層次結構中,為整個設計創建規範。

即:

Project docs spec project_spec.rst conf.py modules module1 docs module1.rst src module2 docs module2.rst src 

我試圖在主 project_spec.rst 文檔目錄樹中包含文件,如下所示:

.. toctree:: :numbered: :maxdepth: 2 Module 1 < ;../../modules/module1/docs/module1> 

但是這個錯誤消息的結果是:

警告:toctree 包含對不存在的文檔 u"modules/module1/docs/module1" 的引用

難道不能以某種方式在文檔路徑中使用 ../ 嗎?

更新:添加 conf.py 位置

更新:除了下面的包含技巧之外,這仍然是(2019)不可能的。有一個未解決的問題不斷被推進:https://github.com/sphinx- doc/sphinx/issues/701