← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to tools/rst2html.py

Turn completion assertions into separate methods.

Many common assertions used to be expressed as arguments to the complete
method.  This makes the checks more explicit, and the code easier to read.

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/rst2html.py
1
 
#! /usr/bin/env python
2
 
 
3
 
# Originally by Dave Goodger, from the docutils, distribution.
4
 
#
5
 
# Modified for Bazaar to accommodate options containing dots
6
 
#
7
 
# This file is in the public domain.
8
 
 
9
 
"""
10
 
A minimal front end to the Docutils Publisher, producing HTML.
11
 
"""
12
 
 
13
 
try:
14
 
    import locale
15
 
    locale.setlocale(locale.LC_ALL, '')
16
 
except:
17
 
    pass
18
 
 
19
 
import docutils
20
 
from docutils.core import publish_cmdline, default_description
21
 
 
22
 
if True: # this is still required in the distutils trunk as-at June 2008.
23
 
    from docutils.parsers.rst.states import Body
24
 
    # we have some option names that contain dot; which is not allowed by
25
 
    # python-docutils 0.4-4 -- so monkeypatch in a better pattern
26
 
    #
27
 
    # This is a bit gross to patch because all this is built up at load time.
28
 
    Body.pats['optname'] = r'[a-zA-Z0-9][a-zA-Z0-9._-]*'    
29
 
    Body.pats['longopt'] = r'(--|/)%(optname)s([ =]%(optarg)s)?' % Body.pats
30
 
    Body.pats['option'] = r'(%(shortopt)s|%(longopt)s)' % Body.pats
31
 
    Body.patterns['option_marker'] = r'%(option)s(, %(option)s)*(  +| ?$)' % Body.pats
32
 
 
33
 
 
34
 
description = ('Generates (X)HTML documents from standalone reStructuredText '
35
 
               'sources.  ' + default_description)
36
 
 
37
 
 
38
 
# workaround for bug with <xxx id="tags" name="tags"> in IE
39
 
from docutils.writers import html4css1
40
 
 
41
 
class IESafeHtmlTranslator(html4css1.HTMLTranslator):
42
 
 
43
 
    def starttag(self, node, tagname, suffix='\n', empty=0, **attributes):
44
 
        x = html4css1.HTMLTranslator.starttag(self, node, tagname, suffix,
45
 
                                              empty, **attributes)
46
 
        y = x.replace('id="tags"', 'id="tags_"')
47
 
        y = y.replace('name="tags"', 'name="tags_"')
48
 
        y = y.replace('href="#tags"', 'href="#tags_"')
49
 
        return y
50
 
 
51
 
mywriter = html4css1.Writer()
52
 
mywriter.translator_class = IESafeHtmlTranslator
53
 
 
54
 
 
55
 
publish_cmdline(writer=mywriter, description=description)