History

mb@mb 04c2824180 adding the 2 submodules again		2018-02-01 14:46:15 +01:00
..
__init__.py	adding the 2 submodules again	2018-02-01 14:46:15 +01:00
better_tables.py	adding the 2 submodules again	2018-02-01 14:46:15 +01:00
LICENSE	adding the 2 submodules again	2018-02-01 14:46:15 +01:00
README.md	adding the 2 submodules again	2018-02-01 14:46:15 +01:00

README.md

Better Tables

This Pelican plugin removes the excess attributes and elements in the HTML tables generated from reST. Trimming this fat allows them to pass HTML5 validation. Hopefully rst2html5 will be merged into Pelican at some point, but until then, this hacky approach is needed.

This approach has the advantage of restoring sanity to tables, and allows their column width to flow normally. All styling is default and must be styled by CSS rather than in HTML attributes.

I make no claim that all HTML table crimes generated are corrected — merely the ones that I have stumbled across.

Requirements

Beautiful Soup 4

What does it do?

At the moment, the following is stripped from tables (though when in doubt, check the source as it may be updated and out-of-sync with this document).

<colgroup> element (and its evil <col> children)
table > border attribute
<tbody> and <thead> > valign attribute

Usage

Enable the plugin in your pelicanconf.py:

PLUGINS = [
    # ...
    'better_tables',
    # ...
]

And that's it. Life's simple like that sometimes.