summaryrefslogtreecommitdiff
path: root/sandbox/code-block-directive/rst2html-highlight
diff options
context:
space:
mode:
Diffstat (limited to 'sandbox/code-block-directive/rst2html-highlight')
-rwxr-xr-xsandbox/code-block-directive/rst2html-highlight36
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/