root/cly/trunk/doc/makedocs.py

#!/usr/bin/env python

import docutils.parsers.rst
import StringIO
from pygments import highlight
from pygments.lexers import get_lexer_by_name
from pygments.formatters import HtmlFormatter

def code_block( name, arguments, options, content, lineno,
             content_offset, block_text, state, state_machine ):
  """
  The code-block directive provides syntax highlighting for blocks
  of code.  It is used with the the following syntax::

  .. code-block:: CPP

    #include <iostream>

    int main( int argc, char* argv[] )
    {
      std::cout << "Hello world" << std::endl;
    }

  The directive requires the name of a language supported by Pygments
  as its only argument.  All code in the indented block following
  the directive will be colourized.  Note that this directive is only
  supported for HTML writers.
  """
  language = arguments[0]
  formatter = HtmlFormatter()

  try:
      lexer = get_lexer_by_name(language)
  except Exception:
    error = state_machine.reporter.error( "No Pygments lexer found "
      "for language '%s'." % language,
      docutils.nodes.literal_block(block_text, block_text), line=lineno )
    return [error]
  io = StringIO.StringIO()
  html = highlight('\n'.join(content), lexer, formatter)
  raw = docutils.nodes.raw('',html, format = 'html')
  return [raw]

code_block.arguments = (1,0,0)
code_block.options = {'language' : docutils.parsers.rst.directives.unchanged }
code_block.content = 1

# Simply importing this module will make the directive available.
docutils.parsers.rst.directives.register_directive( 'code-block', code_block )

if __name__ == "__main__":
  import docutils.core
  docutils.core.publish_cmdline(writer_name='html', argv=['--stylesheet-path=stylesheet.css'])