[Doc-SIG] The docs, reloaded

skip at pobox.com skip at pobox.com
Tue May 22 13:06:30 CEST 2007

    John> I'm fairly new to reST, and don't know all the ins and outs of it,
    John> but I'd always just assumed that either there is or there will be
    John> a simple way to escape to TeX math notation. That is, such that
    John> when you run ``rst2latex``, your equations will come through
    John> unscathed. And when you run ``rst2html``, well, probably png's
    John> will get generated and the html will just link to them as inline
    John> images (of course, you'll need a TeX implementation installed for
    John> that).

PNGs would be fairly yucky.  ASCIIMathML or MathML would be much better.

    John> Writing equations as done with TeX/LaTeX is so universal and
    John> well-known that even if the docutils folks used some other
    John> notation for mathematics in reST-formatted docs, a way to use
    John> TeX-style math would certainly pop out of the woodwork at some
    John> point. There's a lot of folks out there using LaTeX because they
    John> need to put math in their docs, and don't really have any other
    John> workable option.

ASCIIMathML offers LaTeX notation as an option.


More information about the Doc-SIG mailing list