狮身人面像意外章节标题- numpydoc

Question

我无法使狮身人面像在numpy格式下正常工作。我正在用这个示例进行测试，执行"make“，但是我会收到几个警告来识别参数、Notes和返回等。例如：

SEVERE: Unexpected section title.
ERROR: Unexpected indentation.
also
WARNING: Inline emphasis start-string without end-string.
WARNING: Literal block expected; none found

这个问题已经问过了，但经过几个小时的搜索和尝试，我没有成功。

我到现在为止所做的事：

• 已安装狮身人面像v1.3.5
• 将numpydoc更新为0.5版
• 将扩展名numpydoc、sphinxcontrib.napoleon和sphinx.ext.napoleon添加到conf.py文件中。
• 试过rst2html docum.txt docum.html
• 由于我认为它没有使用numydoc，所以我写了一个不正确的名称作为扩展名，它给出了一个错误(应该是这样，所以我认为它是标识numpydoc)。
• 将numpydoc_show_class_members = False添加到conf.py
• 删除整个先前的html输出。

有什么不对的建议或暗示吗？我能试试什么？

谢谢

Answer 1

问题是我使用numpydoc直接用.. toctree:: filename记录一个模块，但它必须与.. automodule:: filename一起使用。在这里有更多关于如何使用它的信息：http://www.sphinx-doc.org/en/stable/tutorial.html#setting-up-the-documentation-sources。谢谢你的帮助。