============== Django Sekizai

|pypi| |build| |coverage|

Sekizai means "blocks" in Japanese, and that's what this app provides. A fresh look at blocks. With django-sekizai you can define placeholders where your blocks get rendered and at different places in your templates append to those blocks. This is especially useful for css and javascript. Your sub-templates can now define css and Javascript files to be included, and the css will be nicely put at the top and the Javascript to the bottom, just like you should. Also sekizai will ignore any duplicate content in a single block.

There are some issue/restrictions with this implementation due to how the django template language works, but if used properly it can be very useful and it is the media handling framework for the django CMS (since version 2.2).

.. note::

    This project is endorsed by the `django CMS Association <https://www.django-cms.org/en/about-us/>`_.
    That means that it is officially accepted by the dCA as being in line with our roadmap vision and development/plugin policy. 
    Join us on `Slack <https://www.django-cms.org/slack/>`_.

Contribute to this project and win rewards

Because this is a an open-source project, we welcome everyone to get involved in the project <https://www.django-cms.org/en/contribute/> and receive a reward <https://www.django-cms.org/en/bounty-program/> for their contribution. Become part of a fantastic community and help us make django CMS the best CMS in the world.

We'll be delighted to receive your feedback in the form of issues and pull requests. Before submitting your pull request, please review our contribution guidelines <http://docs.django-cms.org/en/latest/contributing/index.html>_.

We're grateful to all contributors who have helped create and maintain this package. Contributors are listed at the contributors <https://github.com/django-cms/django-sekizai/graphs/contributors>_ section.

Documentation

See REQUIREMENTS in the setup.py <https://github.com/divio/django-sekizai/blob/master/setup.py>_ file for additional dependencies:

|python| |django|

Please refer to the documentation in the docs/ directory for more information or visit our online documentation <https://django-sekizai.readthedocs.io/en/latest/>_.

Running Tests

You can run tests by executing::

virtualenv env
source env/bin/activate
pip install -r tests/requirements.txt
python setup.py test

.. |pypi| image:: https://badge.fury.io/py/django-sekizai.svg :target: http://badge.fury.io/py/django-sekizai .. |build| image:: https://travis-ci.org/divio/django-sekizai.svg?branch=master :target: https://travis-ci.org/divio/django-sekizai .. |coverage| image:: https://codecov.io/gh/divio/django-sekizai/branch/master/graph/badge.svg :target: https://codecov.io/gh/divio/django-sekizai

.. |python| image:: https://img.shields.io/badge/python-3.5+-blue.svg :target: https://pypi.org/project/django-sekizai/ .. |django| image:: https://img.shields.io/badge/django-2.2,%203.0,%203.1-blue.svg :target: https://www.djangoproject.com/