zinnia-theme-html5

HTML5 theme for django-blog-zinnia


Keywords
django, blog, weblog, zinnia, theme, skin, html5
License
BSD-3-Clause
Install
pip install zinnia-theme-html5==0.4

Documentation

Zinnia-theme-html5

Zinnia-theme-html5 is a python package providing HTML5 templates for django-blog-zinnia.

Installation

First of all you need to install and configure django-app-namespace-template-loader into your project.

Then once Zinnia is installed on your Django project and this package installed on your PYTHON_PATH, simply register the zinnia_html5 application in the INSTALLED_APP section of your project's settings.

Now Zinnia is HTML5 ready.

Warning

  • zinnia_html5 must be registered before the zinnia app to bypass the loading of the Zinnia's templates.
  • You need to use the django.template.loaders.eggs.Loader template loader if you have installed the package as an egg.

HTML5 Validation

If you want to have strict HTML5 documents and pass the validation tests you must register the DraftHTML5ValidatorCleaner middleware to clean the templates of the not already supported attributes or relationships.

MIDDLEWARE_CLASSES = (
    ... # Your middlewares
    'zinnia_html5.middleware.DraftHTML5ValidatorCleaner',
    )

The problem is that HTML5 is still in draft, and some microformats are not already allowed by the on-line validators.

Instead of rewriting all the Zinnia's templates it's easier to add this middleware and disable it when the HTML5 specifications will be completed and the on-line HTML5 validators up-to-date.

Note

You need to install the beautifulsoup4 and html5lib packages for using this middleware.