automatic html generation for documentation?

[John M. Gabriele]

Lonnie Princehouse wrote:
> I plan on writing some documentation that will consist of blocks of
> commentary with interspersed snippets of syntax-colored Python code and
> the occaisional image.
> 
> Does anyone know of a package that will take a high level description
> of what I just described and auto-generate clean-looking web pages,
> including syntax coloring?   I'm already using epydoc for API reference
> generation; what I'm looking for here is just something to help out
> with the narrative so I don't have to spend lots of time fiddling with
> HTML.
> 

The Python wiki http://wiki.python.org/moin/FrontPage uses moinmoin
and their pages contain syntax highlighted (highlit? ;) ) Python code.

Of course, there's always source-highlight
http://www.gnu.org/software/src-highlite/source-highlight.html
which you may be able to work into your current solution with
a little glue.

In fact, come to think of it, if your editor is up to snuff, you
could simply paste the code into your html doc, select that code
in the editor, then filter it through source-highlight in-place.
I use NEdit and I think that could do it easily.

---J
-- 
(remove zeez if demunging email address)