..  #!/usr/bin/python

rst2html-highlight
==================

Docutils front-end with syntax highlight.
  
: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  
  """

Requirements
------------

::  

  try:
      import locale
      locale.setlocale(locale.LC_ALL, '')
  except:
      pass
  
  from docutils.core import publish_cmdline, default_description
  
The `pygments_code_block_directive`_ module defines and registers 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)
  
.. _docutils: http://docutils.sf.net/
.. _pygments_code_block_directive: pygments_code_block_directive.py
.. _pygments: http://pygments.org/
.. _Using Pygments in ReST documents: http://pygments.org/docs/rstdirective/
