2024-09-27 21:26:02 发布
网友
Contents: .. toctree:: :maxdepth: 2 foo.rst bar.rst Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search`
我正在尝试使用sphinx-build . doc构建它。它给了我警告:
sphinx-build . doc
(WARNING/2) toctree references unknown document u'bar'
原因可能是什么
Sphinx在toctree指令中不需要.rst扩展名。假设toctree位于类似index.rst和bar.rst的目录中,请尝试将toctree指令中的foo.rst和bar.rst分别替换为foo和bar
.rst
index.rst
bar.rst
foo.rst
foo
bar
否则,请确保bar.rst在正确的目录中(而不是在父目录或子目录中)
我也犯了这个错误。对我来说,这是因为压痕。“目录树”用3个空格字符缩进,而我用4个空格字符列出了rst文件。为了解决这个问题,我们需要有相同的缩进级别
Sphinx在toctree指令中不需要
.rst
扩展名。假设toctree位于类似index.rst
和bar.rst
的目录中,请尝试将toctree指令中的foo.rst
和bar.rst
分别替换为foo
和bar
否则,请确保
bar.rst
在正确的目录中(而不是在父目录或子目录中)我也犯了这个错误。对我来说,这是因为压痕。“目录树”用3个空格字符缩进,而我用4个空格字符列出了rst文件。为了解决这个问题,我们需要有相同的缩进级别
相关问题 更多 >
编程相关推荐