Skip to content

Latest commit

 

History

History
51 lines (37 loc) · 1.72 KB

README.rst

File metadata and controls

51 lines (37 loc) · 1.72 KB
Raw

Zinnia-theme-html5

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

Installation

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.