在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