Python 警告:toctree包含对Sphinx不存在的文档错误的引用
几天前,我开始使用Sphinx来记录一个python包,我发现了一个常见错误,但我找不到解决方案 我用狮身人面像快速启动来设置一切。我使用“doc/”作为文档根位置。包含我的软件包的文件夹设置为:Python 警告:toctree包含对Sphinx不存在的文档错误的引用,python,python-sphinx,toctree,numpydoc,Python,Python Sphinx,Toctree,Numpydoc,几天前,我开始使用Sphinx来记录一个python包,我发现了一个常见错误,但我找不到解决方案 我用狮身人面像快速启动来设置一切。我使用“doc/”作为文档根位置。包含我的软件包的文件夹设置为: myfolder/ doc/ mypackage/ __init__.py moprob.py ... 快速启动后,我将conf.py中的路径编辑为: import os import sys sys.path.insert(0, os
myfolder/
doc/
mypackage/
__init__.py
moprob.py
...
快速启动后,我将conf.py中的路径编辑为:
import os
import sys
sys.path.insert(0, os.path.abspath('..'))
然后,我将包中的一个脚本添加到index.rst,以了解sphinx的工作原理
.. toctree::
:maxdepth: 2
:caption: Contents:
mypackage/moprob
我得到的错误代码是:
.../index.rst:9: WARNING: toctree contains reference to nonexisting document u'mypackage/moprob'
我尝试过的解决方案:
moprob module
=============
.. automodule:: mypackage.moprob
:members:
然后再次运行sphinx build