#!/usr/bin/python # coding: utf-8 # rst2html-highlight # ================== # # Docutils front-end with syntax highlight. # # :Author: David Goodger, Georg Brandl, Günter Milde # :Date: $Date: 2008-05-22 08:42:52 +0200 (Do, 22. Mai 2008) $ # :Copyright: This module has been placed in the public domain. # # This is a merge of the docutils_ `rst2html` front end with an extension # suggestion by Felix Wiemann. # # :: """ 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::` 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` 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/