'예상치 못한 섹션 제목'인 스핑크스 - 문제가 있습니까?

Question

내 doc/ 디렉토리에

sphinx-build . html/ 

를 실행, 나는 다음과 같은 출력을 얻을 :

$ 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. 

이 파일은 numpy 수입이 있고, 약간의 연구 후에는 스핑크스 사용하는 RST 마크 업처럼 보인다 numpy이 문서화 된 방식에 문제가 있습니다. numpy 가져 오기 가져올 때 html 괜찮아요.

이 문제를 해결하는 가장 좋은 방법은 무엇입니까?

Answer 1

제목이 스레드에 설명되어 있습니다 : https://groups.google.com/d/msg/sphinx-users/MAFTlX8pAvk/B9hx7MuBVbIJ

피에르 GM은 말한다 : 당신이 당신의 문서에 대한 THW NumPy와 표준을 사용하는 것처럼 "프레드릭은, 가 보이는 다음 numpydoc 확장을 사용 을 고려하는 것이 파울리 비르 타넨. 구현 : https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt

: numpydoc 접경 http://sphinx.googlecode.com/svn/contrib/trunk/ "

현재 정보 : 그것은 여기 사용할 수