Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

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.

Source Distribution

django-bundledmedia-0.1b3.tar.gz (11.8 kB view details)

Uploaded Source

File details

Details for the file django-bundledmedia-0.1b3.tar.gz.

File metadata

File hashes

Hashes for django-bundledmedia-0.1b3.tar.gz
Algorithm Hash digest
SHA256 b24121eac3730c26fc75bcd6e91a57a658593590eccabcbbf394cc3a00197773
MD5 2feb8ce5eaa3159201524dfe274038c1
BLAKE2b-256 71f76539da67ea6ee091c95b713e0447f2c06295dfb975b23336eae991cfec6b

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1b3 This release

1 file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page