#!/usr/bin/python # :Author: David Goodger, a Pygments author|contributor, Guenter Milde # :Date: $Date: $ # :Copyright: This module has been placed in the public domain. # This is a merge of the docutils_ `rst2html` front end with an extension # suggestion taken from the pygments_ documentation. """ A front end to docutils, producing HTML with syntax colouring using pygments Generates (X)HTML documents from standalone reStructuredText sources. Uses `pygments` to parse and mark up the content of ``.. code-block::` directives. Needs an adapted stylesheet """ try: import locale locale.setlocale(locale.LC_ALL, '') except: pass from docutils.core import publish_cmdline, default_description # Define and register a new directive `code-block` that uses the `pygments`_ # source highlighter to render code in color. import pygments_code_block_directive # Call the docutils publisher to render the input as html:: description = __doc__ + default_description publish_cmdline(writer_name='html', description=description) # .. _doctutile: http://docutils.sf.net/ # .. _pygments: http://pygments.org/ # .. _Using Pygments in ReST documents: http://pygments.org/docs/rstdirective/