alxf · January 21, 2012 00:10
diff --git a/app.py b/app.py
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-

 """ Render restructured text as html in a pygtk webkit view.
 """

 import gobject
 import gtk
 import io
 import os.path
 import webkit
 import sys

 import publishrst

 class GtkApplication(object):
    """ Application class.
    """
    def __init__(self, rst_file):
        #build main gtk window
        self.rst_file = rst_file
        self.win = gtk.Window()
        self.win.set_default_size(800, 600)
        self.win.connect("destroy", lambda w: gtk.main_quit())

        #build webkit widget
        browser = webkit.WebView()
        with io.open(self.rst_file, 'rb') as fp:
            data = publishrst.html_parts(unicode(fp.read()))['whole']
            browser.load_html_string(data, 'file:///')

        #add widgets and show window
        self.win.add(browser)
        self.win.show_all()

    def run(self):
        gtk.main()

 if __name__ == '__main__':
    if len(sys.argv) > 1:
        gobject.threads_init()
        app = GtkApplication(sys.argv[1])
        app.run()
    else:
        print("usage: %s <rst file>" % os.path.basename(sys.argv[0]))
diff --git a/example.rst b/example.rst
diff --git a/publishrst.py b/publishrst.py
 # Author: David Goodger <[email protected]>
 # Copyright: This module has been placed in the public domain.

 """
 This module contains practical examples of Docutils client code.

 Importing this module from client code is not recommended; its contents are
 subject to change in future Docutils releases.  Instead, it is recommended
 that you copy and paste the parts you need into your own code, modifying as
 necessary.
 """

 from docutils import core, io


 def html_parts(input_string, source_path=None, destination_path=None,
               input_encoding='unicode', doctitle=True,
               initial_header_level=1):
    """
    Given an input string, returns a dictionary of HTML document parts.

    Dictionary keys are the names of parts, and values are Unicode strings;
    encoding is up to the client.

    Parameters:

    - `input_string`: A multi-line text string; required.
    - `source_path`: Path to the source file or object.  Optional, but useful
      for diagnostic output (system messages).
    - `destination_path`: Path to the file or object which will receive the
      output; optional.  Used for determining relative paths (stylesheets,
      source links, etc.).
    - `input_encoding`: The encoding of `input_string`.  If it is an encoded
      8-bit string, provide the correct encoding.  If it is a Unicode string,
      use "unicode", the default.
    - `doctitle`: Disable the promotion of a lone top-level section title to
      document title (and subsequent section title to document subtitle
      promotion); enabled by default.
    - `initial_header_level`: The initial level for header elements (e.g. 1
      for "<h1>").
    """
    overrides = {'input_encoding': input_encoding,
                 'doctitle_xform': doctitle,
                 'initial_header_level': initial_header_level}
    parts = core.publish_parts(
        source=input_string, source_path=source_path,
        destination_path=destination_path,
        writer_name='html', settings_overrides=overrides)
    return parts

 def html_body(input_string, source_path=None, destination_path=None,
              input_encoding='unicode', output_encoding='unicode',
              doctitle=True, initial_header_level=1):
    """
    Given an input string, returns an HTML fragment as a string.

    The return value is the contents of the <body> element.

    Parameters (see `html_parts()` for the remainder):

    - `output_encoding`: The desired encoding of the output.  If a Unicode
      string is desired, use the default value of "unicode" .
    """
    parts = html_parts(
        input_string=input_string, source_path=source_path,
        destination_path=destination_path,
        input_encoding=input_encoding, doctitle=doctitle,
        initial_header_level=initial_header_level)
    fragment = parts['html_body']
    if output_encoding != 'unicode':
        fragment = fragment.encode(output_encoding)
    return fragment

 def internals(input_string, source_path=None, destination_path=None,
              input_encoding='unicode', settings_overrides=None):
    """
    Return the document tree and publisher, for exploring Docutils internals.

    Parameters: see `html_parts()`.
    """
    if settings_overrides:
        overrides = settings_overrides.copy()
    else:
        overrides = {}
    overrides['input_encoding'] = input_encoding
    output, pub = core.publish_programmatically(
        source_class=io.StringInput, source=input_string,
        source_path=source_path,
        destination_class=io.NullOutput, destination=None,
        destination_path=destination_path,
        reader=None, reader_name='standalone',
        parser=None, parser_name='restructuredtext',
        writer=None, writer_name='null',
        settings=None, settings_spec=None, settings_overrides=overrides,
        config_section=None, enable_exit_status=None)
    return pub.writer.document, pub
	#!/usr/bin/env python
	# -- coding: utf-8 --

	""" Render restructured text as html in a pygtk webkit view.
	"""

	import gobject
	import gtk
	import io
	import os.path
	import webkit
	import sys

	import publishrst

	class GtkApplication(object):
	""" Application class.
	"""
	def __init__(self, rst_file):
	#build main gtk window
	self.rst_file = rst_file
	self.win = gtk.Window()
	self.win.set_default_size(800, 600)
	self.win.connect("destroy", lambda w: gtk.main_quit())

	#build webkit widget
	browser = webkit.WebView()
	with io.open(self.rst_file, 'rb') as fp:
	data = publishrst.html_parts(unicode(fp.read()))['whole']
	browser.load_html_string(data, 'file:///')

	#add widgets and show window
	self.win.add(browser)
	self.win.show_all()

	def run(self):
	gtk.main()

	if __name__ == '__main__':
	if len(sys.argv) > 1:
	gobject.threads_init()
	app = GtkApplication(sys.argv[1])
	app.run()
	else:
	print("usage: %s <rst file>" % os.path.basename(sys.argv[0]))
	# Author: David Goodger <[email protected]>
	# Copyright: This module has been placed in the public domain.

	"""
	This module contains practical examples of Docutils client code.

	Importing this module from client code is not recommended; its contents are
	subject to change in future Docutils releases. Instead, it is recommended
	that you copy and paste the parts you need into your own code, modifying as
	necessary.
	"""

	from docutils import core, io


	def html_parts(input_string, source_path=None, destination_path=None,
	input_encoding='unicode', doctitle=True,
	initial_header_level=1):
	"""
	Given an input string, returns a dictionary of HTML document parts.

	Dictionary keys are the names of parts, and values are Unicode strings;
	encoding is up to the client.

	Parameters:

	- `input_string`: A multi-line text string; required.
	- `source_path`: Path to the source file or object. Optional, but useful
	for diagnostic output (system messages).
	- `destination_path`: Path to the file or object which will receive the
	output; optional. Used for determining relative paths (stylesheets,
	source links, etc.).
	- `input_encoding`: The encoding of `input_string`. If it is an encoded
	8-bit string, provide the correct encoding. If it is a Unicode string,
	use "unicode", the default.
	- `doctitle`: Disable the promotion of a lone top-level section title to
	document title (and subsequent section title to document subtitle
	promotion); enabled by default.
	- `initial_header_level`: The initial level for header elements (e.g. 1
	for "<h1>").
	"""
	overrides = {'input_encoding': input_encoding,
	'doctitle_xform': doctitle,
	'initial_header_level': initial_header_level}
	parts = core.publish_parts(
	source=input_string, source_path=source_path,
	destination_path=destination_path,
	writer_name='html', settings_overrides=overrides)
	return parts

	def html_body(input_string, source_path=None, destination_path=None,
	input_encoding='unicode', output_encoding='unicode',
	doctitle=True, initial_header_level=1):
	"""
	Given an input string, returns an HTML fragment as a string.

	The return value is the contents of the <body> element.

	Parameters (see `html_parts()` for the remainder):

	- `output_encoding`: The desired encoding of the output. If a Unicode
	string is desired, use the default value of "unicode" .
	"""
	parts = html_parts(
	input_string=input_string, source_path=source_path,
	destination_path=destination_path,
	input_encoding=input_encoding, doctitle=doctitle,
	initial_header_level=initial_header_level)
	fragment = parts['html_body']
	if output_encoding != 'unicode':
	fragment = fragment.encode(output_encoding)
	return fragment

	def internals(input_string, source_path=None, destination_path=None,
	input_encoding='unicode', settings_overrides=None):
	"""
	Return the document tree and publisher, for exploring Docutils internals.

	Parameters: see `html_parts()`.
	"""
	if settings_overrides:
	overrides = settings_overrides.copy()
	else:
	overrides = {}
	overrides['input_encoding'] = input_encoding
	output, pub = core.publish_programmatically(
	source_class=io.StringInput, source=input_string,
	source_path=source_path,
	destination_class=io.NullOutput, destination=None,
	destination_path=destination_path,
	reader=None, reader_name='standalone',
	parser=None, parser_name='restructuredtext',
	writer=None, writer_name='null',
	settings=None, settings_spec=None, settings_overrides=overrides,
	config_section=None, enable_exit_status=None)
	return pub.writer.document, pub