=================
Django Compressor
=================

Compresses linked and inline JavaScript or CSS into a single cached file.

Why another static file combiner for Django?
============================================

Short version: None of them did exactly what I needed.

Long version:

**JS/CSS belong in the templates**
  Every static combiner for Django I've seen makes you configure
  your static files in your ``settings.py``. While that works, it doesn't make
  sense. Static files are for display. And it's not even an option if your
  settings are in completely different repositories and use different deploy
  processes from the templates that depend on them.

**Flexibility**
  Django Compressor doesn't care if different pages use different combinations
  of statics. It doesn't care if you use inline scripts or styles. It doesn't
  get in the way.

**Automatic regeneration and cache-foreverable generated output**
  Statics are never stale and browsers can be told to cache the output forever.

**Full test suite**
  It has one.

Contents
========

.. toctree::
 :maxdepth: 2

 quickstart
 usage
 scenarios
 settings
 remote-storages
 behind-the-scenes
 jinja2
 django-sekizai
 reactjs
 contributing
 changelog