[SciPy-dev] how scipy reference guide is generated
Forrest Sheng Bao
Wed Dec 23 21:04:34 CST 2009
I am getting quite struggling now. I commented my Python code with reST but
i counldn't generate expected HTML file. I expect that I can combine both my
code and comments together in one doc and use Sphinx to only get the code
I have a very simple file, index.py, containing only one dummy function:
"""The sum of two numbers.
a: an integer
b: an integer
a + b, the sum of a and b.
I set up a project under current directory using sphinx-quickstart. And
then, I run "make hitml"
$ make html
sphinx-build -b html -d _build/doctrees . _build/html
Running Sphinx v0.6.3
loading pickled environment... done
building [html]: targets for 0 source files that are out of date
updating environment: [config changed] 3 added, 0 changed, 0 removed
reading sources... [ 66%] index
reST markup error:
/forrest/work/BME/NKdata/Features/sphinx/index.py:5: (SEVERE/4) Unexpected
make: *** [html] Error 1
I do not understand why. Why it is unexpected? And, even if I delete the
---------, the triple quotes bracing my comments in Python file never
disappear in final doc.
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the SciPy-Dev