[Numpy-discussion] Easy way to test documentation?

[Charles R Harris]

On Mon, Oct 5, 2009 at 2:10 PM, Pauli Virtanen <pav@iki.fi> wrote:

> ma, 2009-10-05 kello 13:54 -0600, Charles R Harris kirjoitti:
> > Is there an easy way to test build documentation for a module that is
> > not yet part of numpy?
>
> Make a small Sphinx project for that:
>
> $ easy_install numpydoc
> $ mkdir foo
> $ cd foo
> $ sphinx-quickstart
>

What to choose for math rendering? Defaults for everything else?


> ...
> $ vi conf.py
> ... add 'sphinx.ext.autodoc', 'numpydoc' to extensions ...
> $ cp /some/path/modulename.py modulename.py
> $ vi index.rst
>

index.py, right?


> ...
>  add
>  .. automodule:: modulename
>     :members:
> ...
> $ make PYTHONPATH=$PWD html
>
>
Bombs when it hits the first Parameters section:  "Unexpected section
title."


Could be automated.
>
>
That would be nice.

Chuck
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.scipy.org/pipermail/numpy-discussion/attachments/20091005/c0197b8a/attachment.html