reST filter doesn't render header levels 1 & 2

[benoistlaurent]

Problem

This classical restructured text formatting for section headers is not rendered as expected by django_markup.

********
Header 1
********

Header 2
========

Header 3
--------

Header 1 & 2 are pure and simply forgotten.

Diagnotic

After some investigations, django_markup uses docutils.core.publish_parts to render rst. django_markup uses this code to render rst:

def render(self, text, **kwargs):
    from docutils import core
    publish_args = {'source': text, 'writer_name': 'html4css1'}
    publish_args.update(**kwargs)
    parts = core.publish_parts(**publish_args)
    return parts['fragment']

parts['fragment'] returns body content only from header 3, which is in agreement with the docutils documentation:

parts['fragment'] contains the document body (not the HTML ). In other words, it contains the entire document, less the document title, subtitle, docinfo, header, and footer.

Proposed solution.

Use parts['html_body'] instead of parts['fragment']:

def render(self, text, **kwargs):
    from docutils import core
    publish_args = {'source': text, 'writer_name': 'html4css1'}
    publish_args.update(**kwargs)
    parts = core.publish_parts(**publish_args)
    return parts['html_body']

[bartTC]

Thanks for pointing this out, I wasn't aware! I'm going to setup some tests before merging it.

[bartTC]

This introduced backwards incompatible behavior. See the related commit 69b3e7c for more info.