Skip to main content

Django application for adding compressed CSS and JS files in some prepared slots

Project description

django-bundledmedia
===================

``django-bundledmedia`` is a Django application for adding compressed CSS and
JS files in some prepared slots.

This functionality was splitted out of Merengue CMS.

Installing
----------

* Install package from pypi::

$ easy_install django-bundledmedia

* Include ``bundledmedia`` in the ``INSTALLED_APPS`` setting.

* Include ``bundledmedia.middleware.BundledMediaMiddleware`` in the ``MIDDLEWARE_CLASSES`` setting.

Usage
-----

In your base template (i.e. ``base.html``)::

{% load bundledmedia %}
<html>
<head>
{# placeholder to allow plugins and other templates to add css assets #}
{% bundledmedia "css" "css" %}
...
{% bundledmedia "extracss" "css" %}
</head>
<body>
...
{# placeholder to allow plugins and other templates to add javascript assets #}
{% bundledmedia "js" "js" %}
</body>
</html>

In your included template (i.e. ``inc.sidebar.html``)::

{% load bundledmedia %}
{% addmedia "css" %}
<link rel="stylesheet" type="text/css" href="{{ MEDIA_URL }}css/sidebar.css"/>
{% endaddmedia %}
{% addmedia "js" %}
<script language="javascript" src="{{ MEDIA_URL }}js/jquery.sidebar.js"></script>
{% endaddmedia %}
...

In your specific template (i.e. ``myview.html``)::

{% load bundledmedia %}
{% addmedia "extracss" %}
<link rel="stylesheet" type="text/css" href="{{ MEDIA_URL }}css/myview.css"/>
{% endaddmedia %}
...

This code will render all chunks of code of all the included templates in the
placeholders above.

Compression
-----------

``django-bundledmedia`` uses ``django-compressor`` to render compressed CSS and
JS when the ``COMPRESS`` setting is set to ``True``

0.1b3
----

* Backward incompatible improvement: using new ``media_type`` parameter to get a more explicit type definition (JS or CSS).

0.1b2
----

* Not generating compressed JS or CSS if there is no content to compress.

0.1b1
----

* More flexible naming conventions in the bundled blocks.

0.1a
----

* Initial version.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-bundledmedia, version 0.1b3
Filename, size File type Python version Upload date Hashes
Filename, size django-bundledmedia-0.1b3.tar.gz (11.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page