未知指令类型 "toctree" 。Pycharm 中的错误,但索引.html有效



在PyCharm中工作时,我在Sphinx中创建的文档的预览模式显示:

System Message: ERROR/3 (<stdin>, line 9)
Unknown directive type "toctree".
..toctree::
:maxdepth: 2
file1
file2

我在conf.py文件中包含了autodoc扩展名。当我打开/build/index.html文件时,它工作得很好。因此,我的问题是:如何从PyCharm预览模式中删除这个错误,这样我就可以预览我的文档,而不必一直打开/build/index.html文件?

Sphinx构建在Docutils库之上。toctree指令适用于Sphinx,但Docutils无法识别它。

PyCharm预览版不使用狮身人面像(自2019年起,免费社区版和专业版都是如此(;它可能使用来自Docutils的rst2html.py。

此邮件列表线程出现了相同的错误:https://web.archive.org/web/20180715103227/https://mail.python.org/pipermail/python-list/2008 June/493826.html

相关内容

最新更新