Jonathan Guyer wrote:
On Dec 13, 2006, at 10:29 AM, Neal Becker wrote:
Sorry, I'm not sure what you mean here. I am looking at epydoc3.0alpha3 source.
I have no experience with epydoc 3, other than knowing it exists. It's on my list.
I see that epydoc can _parse_ rst. Is that what you mean by working with docutils?
Yes. What did you mean?
I also see that epydoc can write (some kind of) latex. Is that the idea?
Yes.
Feed Python code (with reST docstrings) through epydoc and you get LaTeX or HTML out. For straight reST files, like READMEs, we just invoke docutils directly. I don't think epydoc is of any use there.
I'm looking to markup my python code, including latex so I can nicely include math. I see I could use epydoc, and that epydoc can read rst, but does this allow me to include latex? If so, how? And what backends would then be used to generate either pdf or (x)html?