'Titre de section inattendu' avec Sphinx - est-ce le problème numpy?

Question

Lors de l'exécution

sphinx-build . html/ 

dans mon répertoire doc/, je reçois la sortie suivante:

$ sphinx-build . html/ 
Running Sphinx v0.6.4 
No builder selected, using default: html 
loading pickled environment... done 
building [html]: targets for 0 source files that are out of date 
updating environment: 0 added, 1 changed, 0 removed 
reading sources... [100%] index     
reST markup error: 
HIDDEN/PATH/matplotlib_visualization.py:docstring of simulator.extensions.matplotlib_visualization.beta:20: (SEVERE/4) Unexpected section title. 

Ce fichier a numpy les importations, et après un peu de recherche, il semble que le balisage TVD usages sphinx a un problème avec la façon dont numpy est documentée. Lorsque je supprime l'importation numpy, le code HTML se construit correctement.

Quelle serait la meilleure façon de résoudre ce problème?

Answer 1

Le sujet est abordé dans ce fil: https://groups.google.com/d/msg/sphinx-users/MAFTlX8pAvk/B9hx7MuBVbIJ

Pierre GM dit: « fredrik, On dirait que vous utilisez la norme THW NumPy pour votre documentation Tenez compte puis en utilisant les extensions de numpydoc que Pauli Virtanen. mis en œuvre: il est ici: http://sphinx.googlecode.com/svn/contrib/trunk/ "

les informations actuelles butent numpydoc: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt