Tag Archives: cog

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

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

Posted in Python | Tagged , , , , | 2 Comments