Merged 2.8 branch r30721:30722 into 2.9 branch.

(Fix for collector #1770 that never made it.)

lib/python/reStructuredText/__init__.py

@@ -140,16 +140,25 @@ def HTML(src,
                   'title': parts['title'],
              }
 
+    subheader = '<h%(level)s class="subtitle">%(subtitle)s</h%(level)s>\n' % {
+                  'level': initial_header_level+1,
+                  'subtitle': parts['subtitle'],
+             }
+    
     body = '%(docinfo)s%(body)s' % {
                   'docinfo': parts['docinfo'],
                   'body': parts['body'],
              }
 
+
+    output = ''
     if parts['title']:
-        output = header + body
-    else:
-        output = body
+        output = output + header
+    if parts['subtitle']:
+        output = output + subheader
+    output = output + body
 
+    
     warnings = ''.join(warning_stream.messages)
 
     return output.encode(output_encoding)

lib/python/reStructuredText/tests/testReST.py

 
 import unittest
 
+from reStructuredText import HTML
+
 
 class TestReST(unittest.TestCase):
 
@@ -8,8 +10,22 @@ class TestReST(unittest.TestCase):
         # Make sure we can import the rst parser
         from docutils.parsers import rst
 
+    def testWithSingleSubtitle(self):
+        input = '''
+title
+-----
+subtitle
+++++++++
+text
+'''     
+        expected='''<h3 class="title">title</h3>
+<h4 class="subtitle">subtitle</h4>
+<p>text</p>
+'''
+        output = HTML(input)     
+        self.assertEquals(output, expected) 
+
 
 def test_suite():
     from unittest import TestSuite, makeSuite
     return TestSuite((makeSuite(TestReST),))
-