~bzr-pqm/bzr/bzr.dev

3092.4.1 by Martin Pool
Make our version of rst2html monkey-patch around docutils not accepting . in an option name
1
#! /usr/bin/env python
1928.2.1 by Alexander Belchenko
New target to produce html docs to upload on server
2
3092.4.1 by Martin Pool
Make our version of rst2html monkey-patch around docutils not accepting . in an option name
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.
1928.2.1 by Alexander Belchenko
New target to produce html docs to upload on server
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
3092.4.1 by Martin Pool
Make our version of rst2html monkey-patch around docutils not accepting . in an option name
19
import docutils
1928.2.1 by Alexander Belchenko
New target to produce html docs to upload on server
20
from docutils.core import publish_cmdline, default_description
21
22
3092.4.1 by Martin Pool
Make our version of rst2html monkey-patch around docutils not accepting . in an option name
23
if docutils.__version__ <= '0.4.1':
24
    from docutils.parsers.rst.states import Body
25
    # we have some option names that contain dot; which is not allowed by
26
    # python-docutils 0.4-4 -- so monkeypatch in a better pattern
27
    #
28
    # This is a bit gross to patch because all this is built up at load time.
29
    Body.pats['optname'] = r'[a-zA-Z0-9][a-zA-Z0-9._-]*'    
30
    Body.pats['longopt'] = r'(--|/)%(optname)s([ =]%(optarg)s)?' % Body.pats
31
    Body.pats['option'] = r'(%(shortopt)s|%(longopt)s)' % Body.pats
32
    Body.patterns['option_marker'] = r'%(option)s(, %(option)s)*(  +| ?$)' % Body.pats
33
34
1928.2.1 by Alexander Belchenko
New target to produce html docs to upload on server
35
description = ('Generates (X)HTML documents from standalone reStructuredText '
36
               'sources.  ' + default_description)
37
2677.1.1 by Alexander Belchenko
rst2html: workaround for IE bug with id="tags"
38
39
# workaround for bug with <xxx id="tags" name="tags"> in IE
40
from docutils.writers import html4css1
41
42
class IESafeHtmlTranslator(html4css1.HTMLTranslator):
43
44
    def starttag(self, node, tagname, suffix='\n', empty=0, **attributes):
45
        x = html4css1.HTMLTranslator.starttag(self, node, tagname, suffix,
46
                                              empty, **attributes)
47
        y = x.replace('id="tags"', 'id="tags_"')
48
        y = y.replace('name="tags"', 'name="tags_"')
49
        y = y.replace('href="#tags"', 'href="#tags_"')
50
        return y
51
52
mywriter = html4css1.Writer()
53
mywriter.translator_class = IESafeHtmlTranslator
54
55
56
publish_cmdline(writer=mywriter, description=description)