루트 문서 아래의 디렉토리에 없는 문서에 스핑크스를 연결할 수 있습니까?

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

Python이 아닌 프로젝트를 문서화하기 위해 Sphinx를 사용하고 있습니다. 각 하위 모듈에 ./doc 폴더를 배포하고 해당 모듈을 문서화하기 위해 submodule_name.rst 파일을 포함하고 있습니다. 그런 다음 해당 파일을 마스터 계층 구조로 가져와 전체 디자인에 대한 사양을 만들고 싶습니다.

예:

프로젝트 문서 사양 project_spec.rst conf.py 모듈 module1 문서 module1.rst src module2 문서 module2.rst src 

다음과 같이 마스터 project_spec.rst 문서 toctree에 파일을 포함하려고 했습니다.

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

그러나 이 오류 메시지 결과:

경고: toctree에는 존재하지 않는 문서 u"modules/module1/docs/module1"에 대한 참조가 포함되어 있습니다.

문서 경로에 ../를 어떻게든 사용할 수 없나요?

업데이트: conf.py 위치 추가

업데이트 : 아래의 포함 트릭 외에는 아직(2019) 불가능합니다. 계속해서 추진되고 있는 미해결 문제가 있습니다. https://github.com/sphinx- 문서/스핑크스/문제/701