return 0    def visit_paragraph(self, node):        if self.should_be_compact_paragraph(node):            self.context.append('')        else:            self.body.append(self.starttag(node, 'p', ''))            self.context.append('</p>\n')    def depart_paragraph(self, node):        self.body.append(self.context.pop())    def visit_problematic(self, node):        if node.hasattr('refid'):            self.body.append('<a href="#%s" name="%s">' % (node['refid'],                                                           node['ids'][0]))            self.context.append('</a>')        else:            self.context.append('')        self.body.append(self.starttag(node, 'span', '', CLASS='problematic'))    def depart_problematic(self, node):        self.body.append('</span>')        self.body.append(self.context.pop())    def visit_raw(self, node):        if 'html' in node.get('format', '').split():            t = isinstance(node.parent, nodes.TextElement) and 'span' or 'div'            if node['classes']:                self.body.append(self.starttag(node, t, suffix=''))            self.body.append(node.astext())            if node['classes']:                self.body.append('</%s>' % t)        # Keep non-HTML raw text out of output:        raise nodes.SkipNode    def visit_reference(self, node):        if node.has_key('refuri'):            href = node['refuri']            if ( self.settings.cloak_email_addresses                 and href.startswith('mailto:')):                href = self.cloak_mailto(href)                self.in_mailto = 1        else:            assert node.has_key('refid'), \                   'References must have "refuri" or "refid" attribute.'            href = '#' + node['refid']        atts = {'href': href, 'class': 'reference'}        if not isinstance(node.parent, nodes.TextElement):            assert len(node) == 1 and isinstance(node[0], nodes.image)            atts['class'] += ' image-reference'        self.body.append(self.starttag(node, 'a', '', **atts))    def depart_reference(self, node):        self.body.append('</a>')        if not isinstance(node.parent, nodes.TextElement):            self.body.append('\n')        self.in_mailto = 0    def visit_revision(self, node):        self.visit_docinfo_item(node, 'revision', meta=None)    def depart_revision(self, node):        self.depart_docinfo_item()    def visit_row(self, node):        self.body.append(self.starttag(node, 'tr', ''))        node.column = 0    def depart_row(self, node):        self.body.append('</tr>\n')    def visit_rubric(self, node):        self.body.append(self.starttag(node, 'p', '', CLASS='rubric'))    def depart_rubric(self, node):        self.body.append('</p>\n')    def visit_section(self, node):        self.section_level += 1        self.body.append(            self.start_tag_with_title(node, 'div', CLASS='section'))    def depart_section(self, node):        self.section_level -= 1        self.body.append('</div>\n')    def visit_sidebar(self, node):        self.body.append(            self.start_tag_with_title(node, 'div', CLASS='sidebar'))        self.set_first_last(node)        self.in_sidebar = 1    def depart_sidebar(self, node):        self.body.append('</div>\n')        self.in_sidebar = None    def visit_status(self, node):        self.visit_docinfo_item(node, 'status', meta=None)    def depart_status(self, node):        self.depart_docinfo_item()    def visit_strong(self, node):        self.body.append('<strong>')    def depart_strong(self, node):        self.body.append('</strong>')    def visit_subscript(self, node):        self.body.append(self.starttag(node, 'sub', ''))    def depart_subscript(self, node):        self.body.append('</sub>')    def visit_substitution_definition(self, node):        """Internal only."""        raise nodes.SkipNode    def visit_substitution_reference(self, node):        self.unimplemented_visit(node)    def visit_subtitle(self, node):        if isinstance(node.parent, nodes.sidebar):            self.body.append(self.starttag(node, 'p', '',                                           CLASS='sidebar-subtitle'))            self.context.append('</p>\n')        elif isinstance(node.parent, nodes.document):            self.body.append(self.starttag(node, 'h2', '', CLASS='subtitle'))            self.context.append('</h2>\n')            self.in_document_title = len(self.body)        elif isinstance(node.parent, nodes.section):            tag = 'h%s' % (self.section_level + self.initial_header_level - 1)            self.body.append(                self.starttag(node, tag, '', CLASS='section-subtitle') +                self.starttag({}, 'span', '', CLASS='section-subtitle'))            self.context.append('</span></%s>\n' % tag)    def depart_subtitle(self, node):        self.body.append(self.context.pop())        if self.in_document_title:            self.subtitle = self.body[self.in_document_title:-1]            self.in_document_title = 0            self.body_pre_docinfo.extend(self.body)            self.html_subtitle.extend(self.body)            del self.body[:]    def visit_superscript(self, node):        self.body.append(self.starttag(node, 'sup', ''))    def depart_superscript(self, node):        self.body.append('</sup>')    def visit_system_message(self, node):        self.body.append(self.starttag(node, 'div', CLASS='system-message'))        self.body.append('<p class="system-message-title">')        attr = {}        backref_text = ''        if node['ids']:            attr['name'] = node['ids'][0]        if len(node['backrefs']):            backrefs = node['backrefs']            if len(backrefs) == 1:                backref_text = ('; <em><a href="#%s">backlink</a></em>'                                % backrefs[0])            else:                i = 1                backlinks = []                for backref in backrefs:                    backlinks.append('<a href="#%s">%s</a>' % (backref, i))                    i += 1                backref_text = ('; <em>backlinks: %s</em>'                                % ', '.join(backlinks))        if node.hasattr('line'):            line = ', line %s' % node['line']        else:            line = ''        if attr:            a_start = self.starttag({}, 'a', '', **attr)            a_end = '</a>'        else:            a_start = a_end = ''        self.body.append('System Message: %s%s/%s%s '                         '(<tt class="docutils">%s</tt>%s)%s</p>\n'                         % (a_start, node['type'], node['level'], a_end,                            self.encode(node['source']), line, backref_text))    def depart_system_message(self, node):        self.body.append('</div>\n')    def visit_table(self, node):        self.body.append(            self.starttag(node, 'table', CLASS='docutils', border="1"))    def depart_table(self, node):        self.body.append('</table>\n')    def visit_target(self, node):        if not (node.has_key('refuri') or node.has_key('refid')                or node.has_key('refname')):            self.body.append(self.starttag(node, 'span', '', CLASS='target'))            self.context.append('</span>')        else:            self.context.append('')    def depart_target(self, node):        self.body.append(self.context.pop())    def visit_tbody(self, node):        self.write_colspecs()        self.body.append(self.context.pop()) # '</colgroup>\n' or ''        self.body.append(self.starttag(node, 'tbody', valign='top'))    def depart_tbody(self, node):        self.body.append('</tbody>\n')    def visit_term(self, node):        self.body.append(self.starttag(node, 'dt', ''))    def depart_term(self, node):        """        Leave the end tag to `self.visit_definition()`, in case there's a        classifier.        """        pass    def visit_tgroup(self, node):        # Mozilla needs <colgroup>:        self.body.append(self.starttag(node, 'colgroup'))        # Appended by thead or tbody:        self.context.append('</colgroup>\n')        node.stubs = []    def depart_tgroup(self, node):        pass    def visit_thead(self, node):        self.write_colspecs()        self.body.append(self.context.pop()) # '</colgroup>\n'        # There may or may not be a <thead>; this is for <tbody> to use:        self.context.append('')        self.body.append(self.starttag(node, 'thead', valign='bottom'))    def depart_thead(self, node):        self.body.append('</thead>\n')    def visit_tip(self, node):        self.visit_admonition(node, 'tip')    def depart_tip(self, node):        self.depart_admonition()    def visit_title(self, node, move_ids=1):        """Only 6 section levels are supported by HTML."""        check_id = 0        close_tag = '</p>\n'        if isinstance(node.parent, nodes.topic):            self.body.append(                  self.starttag(node, 'p', '', CLASS='topic-title first'))            check_id = 1        elif isinstance(node.parent, nodes.sidebar):            self.body.append(                  self.starttag(node, 'p', '', CLASS='sidebar-title'))            check_id = 1        elif isinstance(node.parent, nodes.Admonition):            self.body.append(                  self.starttag(node, 'p', '', CLASS='admonition-title'))            check_id = 1        elif isinstance(node.parent, nodes.table):            self.body.append(                  self.starttag(node, 'caption', ''))            check_id = 1            close_tag = '</caption>\n'        elif isinstance(node.parent, nodes.document):            self.body.append(self.starttag(node, 'h1', '', CLASS='title'))            self.context.append('</h1>\n')            self.in_document_title = len(self.body)        else:            assert isinstance(node.parent, nodes.section)            h_level = self.section_level + self.initial_header_level - 1            atts = {}            if (len(node.parent) >= 2 and                isinstance(node.parent[1], nodes.subtitle)):                atts['CLASS'] = 'with-subtitle'            self.body.append(                  self.starttag(node, 'h%s' % h_level, '', **atts))            atts = {}            # !!! conditional to be removed in Docutils 0.5:            if move_ids:                if node.parent['ids']:                    atts['ids'] = node.parent['ids']            if node.hasattr('refid'):                atts['class'] = 'toc-backref'                atts['href'] = '#' + node['refid']            if atts:                self.body.append(self.starttag({}, 'a', '', **atts))                self.context.append('</a></h%s>\n' % (h_level))            else:                self.context.append('</h%s>\n' % (h_level))        # !!! conditional to be removed in Docutils 0.5:        if check_id:            if node.parent['ids']:                atts={'ids': node.parent['ids']}                self.body.append(                    self.starttag({}, 'a', '', **atts))                self.context.append('</a>' + close_tag)            else:                self.context.append(close_tag)    def depart_title(self, node):        self.body.append(self.context.pop())        if self.in_document_title:            self.title = self.body[self.in_document_title:-1]            self.in_document_title = 0            self.body_pre_docinfo.extend(self.body)            self.html_title.extend(self.body)            del self.body[:]    def visit_title_reference(self, node):        self.body.append(self.starttag(node, 'cite', ''))    def depart_title_reference(self, node):        self.body.append('</cite>')    def visit_topic(self, node):        self.body.append(self.start_tag_with_title(node, 'div', CLASS='topic'))        self.topic_classes = node['classes']    def depart_topic(self, node):        self.body.append('</div>\n')        self.topic_classes = []    def visit_transition(self, node):        self.body.append(self.emptytag(node, 'hr', CLASS='docutils'))    def depart_transition(self, node):        pass    def visit_version(self, node):        self.visit_docinfo_item(node, 'version', meta=None)    def depart_version(self, node):        self.depart_docinfo_item()    def visit_warning(self, node):        self.visit_admonition(node, 'warning')    def depart_warning(self, node):        self.depart_admonition()    def unimplemented_visit(self, node):        raise NotImplementedError('visiting unimplemented node type: %s'                                  % node.__class__.__name__)class SimpleListChecker(nodes.GenericNodeVisitor):    """    Raise `nodes.NodeFound` if non-simple list item is encountered.    Here "simple" means a list item containing nothing other than a single    paragraph, a simple list, or a paragraph followed by a simple list.    """    def default_visit(self, node):        raise nodes.NodeFound    def visit_bullet_list(self, node):        pass    def visit_enumerated_list(self, node):        pass    def visit_list_item(self, node):        children = []        for child in node.children:            if not isinstance(child, nodes.Invisible):                children.append(child)        if (children and isinstance(children[0], nodes.paragraph)            and (isinstance(children[-1], nodes.bullet_list)                 or isinstance(children[-1], nodes.enumerated_list))):            children.pop()        if len(children) <= 1:            return        else:            raise nodes.NodeFound    def visit_paragraph(self, node):        raise nodes.SkipNode    def invisible_visit(self, node):        """Invisible nodes should be ignored."""        raise nodes.SkipNode    visit_comment = invisible_visit    visit_substitution_definition = invisible_visit    visit_target = invisible_visit    visit_pending = invisible_visit