Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Definitions for a reStructuredText code-block directive using pygments, and scripts to render HTML and LaTeX.
Python
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
data
.gitignore
README.rst
pygments_code_block_directive.py
rst2html-highlight.py
rst2latex-highlight.py

README.rst

rst2html-highlight

Docutils front-end with syntax highlight.

Author: David Goodger, a Pygments author|contributor, Guenter Milde
Date: $Date: 2008-05-22 08:42:52 +0200 (Don, 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 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)
Something went wrong with that request. Please try again.