The Sphinx documentation system from team pocoo, with Pygments extended for COBOL source listings. …
Well met,
The OpenCOBOL FAQ (http://opencobol.add1tocobol.com) uses reStructuredText (http://docutils.sourceforge.net/rst.html) for its markup. It's a readable form, powerful and produces nice HTML/CSS output.
The pocoo team has extended the usefulness with Sphinx. (http://sphinx.pocoo.org)
With its extensions, Sphinx is now being used to produce LaTeX and Texinfo forms of the ocfaq document. I might even take a kick at the ePub output and see how the OpenCOBOL FAQ will look on a Kobo.
I'd really like to thank David Goodger and the Python Docutils team for reStructuredText, and the great folk at pocoo for Sphinx.
Do yourself a favour, yum install python-sphinx
Cheers,
Brian
