Hi, I just installed sphinx-0.5 (dev) to try out the math support, and I'm very happy with it! Latex surely beats ASCII-art math. I've started converting the mpmath docs to use it; you can see it in some of the docstrings on this page: http://mpmath.googlecode.com/svn/trunk/doc/build/functions.html (see e.g. the function "gammainc")
I am particularly happy that the mathpng extension works "out of the box" on Windows (as it should, but I've had plenty of experience of latex-interacting software that doesn't). That said, three things need improvement: 1. Inline equations need proper vertical alignment. 2. Displayed equations should be either centered or indented. (Did I miss an obvious way to accomplish this? Either way, it should be default.) 3. The formulas should be rendered with a larger/thicker font. The default output from dvipng is hard to read, especially on some monitors (such as my laptop); in fact subscripts and superscripts can get impossible to read. There is no particular stylistic reason to have equations so small since Sphinx by default uses a rather large font for the surrounding text anyway. To cover all three points, I suggest that Sphinx copies the math style used on Wikipedia, which works very well. By the way, would it be possible to optionally support the less intrusive $...$ markup for inline formulas? I've never used a $ sign in a Python docstring, so it shouldn't cause any problems. Fredrik --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
