Sphinx pode vincular a documentos que não estão localizados em diretórios abaixo do documento raiz?

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

Estou usando o Sphinx para documentar um projeto não Python. Eu quero distribuir as pastas ./doc em cada submódulo, contendo arquivos submodule_name.rst para documentar aquele módulo. Eu então quero sugar esses arquivos para a hierarquia mestre para criar uma especificação para todo o design.

Isto:

Documentos do projeto spec project_spec.rst conf.py modules module1 docs module1.rst src module2 docs module2.rst src 

Tentei incluir arquivos no documento mestre project_spec.rst toctree assim:

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

No entanto, esta mensagem de erro resulta:

AVISO: toctree contém referência a um documento inexistente u"modules/module1/docs/module1"

Não é possível usar ../ em um caminho de documento de alguma forma?

Atualização: Adicionada localização do conf.py

Atualização : Além do truque de inclusão abaixo, isso ainda (2019) não é possível. Há um problema em aberto que continua sendo adiado: https://github.com/sphinx- doc/sphinx/issues/701