[Doc-SIG] Python docs in reST

Skip Montanaro skip at pobox.com
Wed May 25 22:42:42 CEST 2005

    Felix> As long as you need to mix LaTeX and reST standard-doc sources,
    Felix> making Docutils output Python-doc-LaTeX seems like the most
    Felix> viable approach.

(I started this thread way back when...)  One of my original motivations was
to make it easier to experiment with different ways of presenting the
generated HTML.  I have a suspicion that tweaking the Docutils HTML
generator would be easier than tweaking latex2html.  For example, I'm aware
of a couple wiki wrappers available to provide annotation capability for
static pages.  Wikalong is a general tool that's unfortunately
Firefox-specific.  Andrew Kuchling wrote an experimental wrapper that's
specific to Python's docs.  It seems to me it would be better to simply
generate HTML output that integrates the annotation capability with the
static display.


More information about the Doc-SIG mailing list