Python sphinx Sphinx目录树包含对不存在文档的引用
我对斯芬克斯很陌生。医生说这很容易设置-也许是这样,但我有一个熊的时间。我终于创建了.rst文件,但是当我更新index.rst时,我遇到了这个错误。我确认.rst文件存在于/docs目录中。下面是我的conf.py中的syspath和索引 我尝试了所有这些组合,但都没有成功,.rst文件位于/home/oiltez/src/Sicom2.0/docs中Python sphinx Sphinx目录树包含对不存在文档的引用,python-sphinx,toctree,Python Sphinx,Toctree,我对斯芬克斯很陌生。医生说这很容易设置-也许是这样,但我有一个熊的时间。我终于创建了.rst文件,但是当我更新index.rst时,我遇到了这个错误。我确认.rst文件存在于/docs目录中。下面是我的conf.py中的syspath和索引 我尝试了所有这些组合,但都没有成功,.rst文件位于/home/oiltez/src/Sicom2.0/docs中 sys.path.insert(0, os.path.abspath('/home/efultz/src/Sicom2.0/')) sys.p
sys.path.insert(0, os.path.abspath('/home/efultz/src/Sicom2.0/'))
sys.path.insert(0, os.path.abspath('/home/efultz/src/Sicom2.0/docs'))
sys.path.insert(0, os.path.abspath('.'))
sys.path.insert(0, os.path.abspath('../'))
sys.path.insert(0, os.path.abspath('../..'))
sys.path.insert(0, '/home/efultz/src/Sicom2.0/')
index.rst中有以下内容-我已确认在各个文件名之前只有3个空格
.. toctree::
:maxdepth: 2
:caption: Contents:
Base
BaseAPI
EventLogger
SICOMToConnex
SICOMToConnexAPI
SICOMToConnexAPIProduct
SICOMToConnexDemo
SICOMToConnexParser
SICOMToConnexParserAPI
SICOMToConnexParserAPIProduct
product
modules
当.RST文件被创建时,我通过配置使用相同的目录而不是拆分目录发现它们位于需要的位置。目录树中列出的文档是否与index.RST位于同一目录中?否-在我生成的文档和源文档下-当index.RST被创建时,.RST文件位于文档下在源目录中。我已将文件移动到源目录,现在一切正常-是否有一个路径可以在不移动文件的情况下工作?我认为您应该将所有RST文件放在docs目录中。修改
sys.path
对目录树的工作方式没有影响。