rst_parser - restructured text support for blog ...

Summary

A reStructuredText entry formatter for pyblosxom. reStructuredText is part of the docutils project (http://docutils.sourceforge.net/). To use, you need a recent version of docutils. A development snapshot (http://docutils.sourceforge.net/#development-snapshots) will work fine.

Install

This plugin comes with Pyblosxom. To install, do the following:

1. Add Pyblosxom.plugins.rst_parser to the load_plugins list in your config.py file.
2. Install docutils. Instructions are at http://docutils.sourceforge.net/

Usage

Blog entries with a .rst extension will be parsed as restructuredText.

You can also configure this as your default preformatter for .txt files by configuring it in your config file as follows:

py['parser'] = 'reST'

Additionally, you can do this on an entry-by-entry basis by adding a #parser reST line in the metadata section. For example:

My Little Blog Entry
#parser reST
My main story...

Configuration

There’s two optional configuration parameter you can for additional control over the rendered HTML:

# To set the starting level for the rendered heading elements.
# 1 is the default.
py['reST_initial_header_level'] = 1

# Enable or disable the promotion of a lone top-level section title to
# document title (and subsequent section title to document subtitle
# promotion); enabled by default.
py['reST_transform_doctitle'] = 1

Note

If you’re not seeing headings that you think should be there, try changing the reST_initial_header_level property to 0.

License

Plugin is distributed under license: MIT