> reST is quite limited (no bibtex support, no math, no small-caps, no > bold-italic, ...) so that this might not work for all.
At least for my software manual, I do not need advanced formatting and the simplicity of reST rules. Note that reST is *extensible* and Sphinx uses many extensions to handle math, note, etc. 1. bibtex could be processed before it is converted to reST references. 2. Sphinx handles math, currently using figures. (My documents have inlined and displayed math) >> Using an improved version of a LaTeX -> reST converter, I was able to >> convert my LyX documents to http://simupop.sourceforge.net/manual/ . > > Could you share this improved LaTeX -> reST converter? >From http://simupop.svn.sourceforge.net/viewvc/simupop/trunk/doc/tools/ , you can find a patch (converter_patch.diff) to the current converter tool (http://svn.python.org/projects/doctools/converter/converter ) and an updated convert.py . Other than figure, note, displayed math and listings support, I added a feature that automatically cross-links italic or typewritter keywords to my reference manual. This is immensely useful to me but may not be useful to others. Cheers, Bo
