#!/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/