Sphinx Неожиданный заголовок раздела - numpydoc

Question

Я не могу корректно работать с Sphinx в формате numpy. Я тестирую с этим example, выполняя «сделать HTML», но я получаю несколько предупреждений распознавать параметры, примечания, возврат и т.д. Например:

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

Этот вопрос не был уже задавала, но у меня нет успех после поиска и попыток в течение нескольких часов.

То, что я не сделал до сих пор:

• установлен Sphinx v1.3.5
• обновленный numpydoc до версии 0,5
• добавлены какие расширения numpydoc, sphinxcontrib.napoleon и sphinx.ext.napoleon в файл conf.py.
• пытался rst2html docum.txt docum.html
• Как я пришла в голову мысль, что он не использовал numydoc, я написал неверное имя, расширение и это дало ошибку (как это должно быть, так что я думаю, что это identifing 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. Спасибо за вашу помощь.