[Numpy-discussion] latex equations in docstrings

Robert Kern robert.kern at gmail.com
Wed Jun 24 16:36:58 EDT 2009

On Wed, Jun 24, 2009 at 15:14, Chris
Kees<christopher.e.kees at usace.army.mil> wrote:
> Hi,
> Apologies if I sent two copies of this message to the list. If I'm using the
> math directive in my docstrings following the scipy guidelines
> (http://projects.scipy.org/numpy/wiki/CodingStyleGuidelines), what tool do I
> need to use in order to generate html with properly formated equations?  I
> read that Sphinx is not primarily intended for API docs, but using epydoc I
> can't seem to get the equations formatted.  Are you guys using Sphinx on the
> numpy/scipy source?

Yes. The HOWTO_BUILD_DOCS.txt is unfortunately out of date.

Robert Kern

"I have come to believe that the whole world is an enigma, a harmless
enigma that is made terrible by our own mad attempt to interpret it as
though it had an underlying truth."
  -- Umberto Eco

More information about the NumPy-Discussion mailing list