Tag Archives: docutils

Documenting python code with reST, docutils, pygments, cog and paver

Posted on May 24, 2010 by Prasanth Nair

This article describes a recipe for producing html documentation for python code in a single file using reST, docutils, cog and paver. reST is used to write the documentation in plain text, cog is used to run the code and insert the results into the documentation, pygments is used to provide syntax highlighting, docutils is used to produce the html and paver is used to automate the process. Continue reading →