diff options
Diffstat (limited to 'sandbox/code-block-directive/rst2html-highlight')
-rwxr-xr-x | sandbox/code-block-directive/rst2html-highlight | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/sandbox/code-block-directive/rst2html-highlight b/sandbox/code-block-directive/rst2html-highlight new file mode 100755 index 000000000..737a8c802 --- /dev/null +++ b/sandbox/code-block-directive/rst2html-highlight @@ -0,0 +1,36 @@ +#!/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/ |