|
|
|
|
@@ -1,424 +1,410 @@
|
|
|
|
|
.. _settings:
|
|
|
|
|
|
|
|
|
|
Settings
|
|
|
|
|
--------
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
.. currentmodule:: django.conf.settings
|
|
|
|
|
|
|
|
|
|
Django Compressor has a number of settings that control its behavior.
|
|
|
|
|
They've been given sensible defaults.
|
|
|
|
|
|
|
|
|
|
.. _compress_enabled:
|
|
|
|
|
Base settings
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
COMPRESS_ENABLED
|
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
.. attribute:: COMPRESS_ENABLED
|
|
|
|
|
|
|
|
|
|
:Default: the opposite of ``DEBUG``
|
|
|
|
|
:default: the opposite of ``DEBUG``
|
|
|
|
|
|
|
|
|
|
Boolean that decides if compression will happen. To test compression
|
|
|
|
|
when ``DEBUG`` is ``True`` COMPRESS_ENABLED_ must also be set to ``True``.
|
|
|
|
|
Boolean that decides if compression will happen. To test compression
|
|
|
|
|
when ``DEBUG`` is ``True`` ``COMPRESS_ENABLED`` must also be set to
|
|
|
|
|
``True``.
|
|
|
|
|
|
|
|
|
|
When COMPRESS_ENABLED_ is ``False`` the input will be rendered without any
|
|
|
|
|
compression except for code with a mimetype matching one listed in the
|
|
|
|
|
COMPRESS_PRECOMPILERS_ setting. These matching files are still passed to the
|
|
|
|
|
precompiler before rendering.
|
|
|
|
|
When ``COMPRESS_ENABLED`` is ``False`` the input will be rendered without
|
|
|
|
|
any compression except for code with a mimetype matching one listed in the
|
|
|
|
|
:attr:`~django.conf.settings.COMPRESS_PRECOMPILERS` setting. These
|
|
|
|
|
matching files are still passed to the precompiler before rendering.
|
|
|
|
|
|
|
|
|
|
An example for some javascript and coffeescript.
|
|
|
|
|
An example for some javascript and coffeescript.
|
|
|
|
|
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
|
|
|
|
|
{% load compress %}
|
|
|
|
|
{% load compress %}
|
|
|
|
|
|
|
|
|
|
{% compress js %}
|
|
|
|
|
<script type="text/javascript" src="/static/js/site-base.js" />
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8" src="/static/js/awesome.coffee" />
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
{% compress js %}
|
|
|
|
|
<script type="text/javascript" src="/static/js/site-base.js" />
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8" src="/static/js/awesome.coffee" />
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
|
|
|
|
|
With COMPRESS_ENABLED_ set to ``False`` this would give you something like
|
|
|
|
|
this::
|
|
|
|
|
With ``COMPRESS_ENABLED`` set to ``False`` this would give you something
|
|
|
|
|
like this::
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript" src="/static/js/site-base.js"></script>
|
|
|
|
|
<script type="text/javascript" src="/static/CACHE/js/8dd1a2872443.js" charset="utf-8"></script>
|
|
|
|
|
<script type="text/javascript" src="/static/js/site-base.js"></script>
|
|
|
|
|
<script type="text/javascript" src="/static/CACHE/js/8dd1a2872443.js" charset="utf-8"></script>
|
|
|
|
|
|
|
|
|
|
.. attribute:: COMPRESS_URL
|
|
|
|
|
|
|
|
|
|
:Default: ``STATIC_URL`` (``MEDIA_URL`` for older Django versions)
|
|
|
|
|
|
|
|
|
|
.. _compress_url:
|
|
|
|
|
Controls the URL that linked files will be read from and compressed files
|
|
|
|
|
will be written to.
|
|
|
|
|
|
|
|
|
|
COMPRESS_URL
|
|
|
|
|
^^^^^^^^^^^^
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
:Default: ``STATIC_URL`` (``MEDIA_URL`` for older Django versions)
|
|
|
|
|
This setting defaults to ``MEDIA_URL`` in case ``STATIC_URL``
|
|
|
|
|
is not given or empty, e.g. on older Django versions (< 1.3).
|
|
|
|
|
|
|
|
|
|
Controls the URL that linked files will be read from and compressed files
|
|
|
|
|
will be written to.
|
|
|
|
|
.. attribute:: COMPRESS_ROOT
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
:Default: ``STATIC_ROOT`` (``MEDIA_ROOT`` for older Django versions)
|
|
|
|
|
|
|
|
|
|
This setting defaults to ``MEDIA_URL`` in case ``STATIC_URL``
|
|
|
|
|
is not given or empty, e.g. on older Django versions (<1.3).
|
|
|
|
|
Controls the absolute file path that linked static will be read from and
|
|
|
|
|
compressed static will be written to when using the default
|
|
|
|
|
:attr:`~django.conf.settings.COMPRESS_STORAGE`
|
|
|
|
|
``compressor.storage.CompressorFileStorage``.
|
|
|
|
|
|
|
|
|
|
.. _compress_root:
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
COMPRESS_ROOT
|
|
|
|
|
^^^^^^^^^^^^^
|
|
|
|
|
This setting defaults to ``MEDIA_ROOT`` in case ``STATIC_ROOT``
|
|
|
|
|
is not given, e.g. on older Django versions (< 1.3).
|
|
|
|
|
|
|
|
|
|
:Default: ``STATIC_ROOT`` (``MEDIA_ROOT`` for older Django versions)
|
|
|
|
|
.. attribute:: COMPRESS_OUTPUT_DIR
|
|
|
|
|
|
|
|
|
|
Controls the absolute file path that linked static will be read from and
|
|
|
|
|
compressed static will be written to when using the default COMPRESS_STORAGE_
|
|
|
|
|
``compressor.storage.CompressorFileStorage``.
|
|
|
|
|
:Default: ``'CACHE'``
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
Controls the directory inside :attr:`~django.conf.settings.COMPRESS_ROOT`
|
|
|
|
|
that compressed files will be written to.
|
|
|
|
|
|
|
|
|
|
This setting defaults to ``MEDIA_ROOT`` in case ``STATIC_ROOT``
|
|
|
|
|
is not given, e.g. on older Django versions (<1.3).
|
|
|
|
|
Backend settings
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
COMPRESS_OUTPUT_DIR
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
.. attribute:: COMPRESS_CSS_FILTERS
|
|
|
|
|
|
|
|
|
|
:Default: ``'CACHE'``
|
|
|
|
|
:default: ``['compressor.filters.css_default.CssAbsoluteFilter']``
|
|
|
|
|
|
|
|
|
|
Controls the directory inside COMPRESS_ROOT_ that compressed files will
|
|
|
|
|
be written to.
|
|
|
|
|
A list of filters that will be applied to CSS.
|
|
|
|
|
|
|
|
|
|
.. _compress_css_filters:
|
|
|
|
|
Possible options are (including their settings):
|
|
|
|
|
|
|
|
|
|
COMPRESS_CSS_FILTERS
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
- ``compressor.filters.css_default.CssAbsoluteFilter``
|
|
|
|
|
|
|
|
|
|
:Default: ``['compressor.filters.css_default.CssAbsoluteFilter']``
|
|
|
|
|
A filter that normalizes the URLs used in ``url()`` CSS statements.
|
|
|
|
|
|
|
|
|
|
A list of filters that will be applied to CSS.
|
|
|
|
|
.. attribute:: COMPRESS_CSS_HASHING_METHOD
|
|
|
|
|
|
|
|
|
|
Possible options are:
|
|
|
|
|
The method to use when calculating the hash to append to
|
|
|
|
|
processed URLs. Either ``'mtime'`` (default) or ``'content'``.
|
|
|
|
|
Use the latter in case you're using multiple server to serve your
|
|
|
|
|
static files.
|
|
|
|
|
|
|
|
|
|
``compressor.filters.css_default.CssAbsoluteFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
- ``compressor.filters.csstidy.CSSTidyFilter``
|
|
|
|
|
|
|
|
|
|
A filter that normalizes the URLs used in ``url()`` CSS statements.
|
|
|
|
|
A filter that passes the CSS content to the CSSTidy_ tool.
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_CSS_HASHING_METHOD`` -- The method to use when calculating
|
|
|
|
|
the hash to append to processed URLs. Either ``'mtime'`` (default) or
|
|
|
|
|
``'content'``. Use the latter in case you're using multiple server to
|
|
|
|
|
serve your static files.
|
|
|
|
|
.. attribute:: COMPRESS_CSSTIDY_BINARY
|
|
|
|
|
|
|
|
|
|
``compressor.filters.csstidy.CSSTidyFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
The CSSTidy binary filesystem path.
|
|
|
|
|
|
|
|
|
|
A filter that passes the CSS content to the CSSTidy_ tool.
|
|
|
|
|
.. attribute:: COMPRESS_CSSTIDY_ARGUMENTS
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_CSSTIDY_BINARY`` -- The CSSTidy binary filesystem path.
|
|
|
|
|
The arguments passed to CSSTidy.
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_CSSTIDY_ARGUMENTS`` -- The arguments passed to CSSTidy.
|
|
|
|
|
- ``compressor.filters.datauri.DataUriFilter``
|
|
|
|
|
|
|
|
|
|
``compressor.filters.datauri.DataUriFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
A filter for embedding media as `data: URIs`_ in the CSS.
|
|
|
|
|
|
|
|
|
|
A filter for embedding media as `data: URIs`_ in the CSS.
|
|
|
|
|
.. attribute:: COMPRESS_DATA_URI_MAX_SIZE
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_DATA_URI_MAX_SIZE`` -- Only files that are smaller than
|
|
|
|
|
this value will be embedded. In bytes.
|
|
|
|
|
Only files that are smaller than this in bytes value will be embedded.
|
|
|
|
|
|
|
|
|
|
``compressor.filters.yui.YUICSSFilter``
|
|
|
|
|
"""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
- ``compressor.filters.yui.YUICSSFilter``
|
|
|
|
|
|
|
|
|
|
A filter that passes the CSS content to the `YUI compressor`_.
|
|
|
|
|
A filter that passes the CSS content to the `YUI compressor`_.
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_YUI_BINARY`` -- The YUI compressor filesystem path. Make sure
|
|
|
|
|
to also prepend this setting with ``java -jar`` if you use that kind of
|
|
|
|
|
distribution.
|
|
|
|
|
.. attribute:: COMPRESS_YUI_BINARY
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_YUI_CSS_ARGUMENTS``-- The arguments passed to the compressor.
|
|
|
|
|
The YUI compressor filesystem path. Make sure to also prepend this
|
|
|
|
|
setting with ``java -jar`` if you use that kind of distribution.
|
|
|
|
|
|
|
|
|
|
``compressor.filters.cssmin.CSSMinFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
.. attribute:: COMPRESS_YUI_CSS_ARGUMENTS
|
|
|
|
|
|
|
|
|
|
A filter that uses Zachary Voase's Python port of the YUI CSS compression
|
|
|
|
|
algorithm cssmin_.
|
|
|
|
|
The arguments passed to the compressor.
|
|
|
|
|
|
|
|
|
|
.. _CSSTidy: http://csstidy.sourceforge.net/
|
|
|
|
|
.. _`data: URIs`: http://en.wikipedia.org/wiki/Data_URI_scheme
|
|
|
|
|
.. _cssmin: http://pypi.python.org/pypi/cssmin/
|
|
|
|
|
- ``compressor.filters.cssmin.CSSMinFilter``
|
|
|
|
|
|
|
|
|
|
A filter that uses Zachary Voase's Python port of the YUI CSS compression
|
|
|
|
|
algorithm cssmin_.
|
|
|
|
|
|
|
|
|
|
.. _CSSTidy: http://csstidy.sourceforge.net/
|
|
|
|
|
.. _`data: URIs`: http://en.wikipedia.org/wiki/Data_URI_scheme
|
|
|
|
|
.. _cssmin: http://pypi.python.org/pypi/cssmin/
|
|
|
|
|
|
|
|
|
|
.. _compress_js_filters:
|
|
|
|
|
|
|
|
|
|
COMPRESS_JS_FILTERS
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
.. attribute:: COMPRESS_JS_FILTERS
|
|
|
|
|
|
|
|
|
|
:Default: ``['compressor.filters.jsmin.JSMinFilter']``
|
|
|
|
|
:Default: ``['compressor.filters.jsmin.JSMinFilter']``
|
|
|
|
|
|
|
|
|
|
A list of filters that will be applied to javascript. Possible options are:
|
|
|
|
|
A list of filters that will be applied to javascript.
|
|
|
|
|
|
|
|
|
|
``compressor.filters.jsmin.JSMinFilter``
|
|
|
|
|
"""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
Possible options are:
|
|
|
|
|
|
|
|
|
|
A filter that uses the jsmin implementation rJSmin_ to compress JavaScript code.
|
|
|
|
|
- ``compressor.filters.jsmin.JSMinFilter``
|
|
|
|
|
|
|
|
|
|
.. _slimit_filter:
|
|
|
|
|
A filter that uses the jsmin implementation rJSmin_ to compress
|
|
|
|
|
JavaScript code.
|
|
|
|
|
|
|
|
|
|
``compressor.filters.jsmin.SlimItFilter``
|
|
|
|
|
"""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
.. _slimit_filter:
|
|
|
|
|
|
|
|
|
|
A filter that uses the jsmin implementation `Slim It`_ to compress JavaScript code.
|
|
|
|
|
- ``compressor.filters.jsmin.SlimItFilter``
|
|
|
|
|
|
|
|
|
|
``compressor.filters.closure.ClosureCompilerFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
A filter that uses the jsmin implementation `Slim It`_ to compress
|
|
|
|
|
JavaScript code.
|
|
|
|
|
|
|
|
|
|
A filter that uses `Google Closure compiler`_.
|
|
|
|
|
- ``compressor.filters.closure.ClosureCompilerFilter``
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_CLOSURE_COMPILER_BINARY`` -- The Closure compiler filesystem
|
|
|
|
|
path. Make sure to also prepend this setting with ``java -jar`` if you
|
|
|
|
|
use that kind of distribution.
|
|
|
|
|
A filter that uses `Google Closure compiler`_.
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_CLOSURE_COMPILER_ARGUMENTS`` -- The arguments passed to the compiler.
|
|
|
|
|
.. attribute:: COMPRESS_CLOSURE_COMPILER_BINARY
|
|
|
|
|
|
|
|
|
|
``compressor.filters.yui.YUIJSFilter``
|
|
|
|
|
""""""""""""""""""""""""""""""""""""""
|
|
|
|
|
The Closure compiler filesystem path. Make sure to also prepend
|
|
|
|
|
this setting with ``java -jar`` if you use that kind of distribution.
|
|
|
|
|
|
|
|
|
|
A filter that passes the JavaScript code to the `YUI compressor`_.
|
|
|
|
|
.. attribute:: COMPRESS_CLOSURE_COMPILER_ARGUMENTS
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_YUI_BINARY`` -- The YUI compressor filesystem path.
|
|
|
|
|
The arguments passed to the compiler.
|
|
|
|
|
|
|
|
|
|
- ``COMPRESS_YUI_JS_ARGUMENTS`` -- The arguments passed to the compressor.
|
|
|
|
|
- ``compressor.filters.yui.YUIJSFilter``
|
|
|
|
|
|
|
|
|
|
.. _rJSmin: http://opensource.perlig.de/rjsmin/
|
|
|
|
|
.. _`Google Closure compiler`: http://code.google.com/closure/compiler/
|
|
|
|
|
.. _`YUI compressor`: http://developer.yahoo.com/yui/compressor/
|
|
|
|
|
.. _`Slim It`: http://slimit.org/
|
|
|
|
|
A filter that passes the JavaScript code to the `YUI compressor`_.
|
|
|
|
|
|
|
|
|
|
.. _compress_precompilers:
|
|
|
|
|
.. attribute:: COMPRESS_YUI_BINARY
|
|
|
|
|
|
|
|
|
|
COMPRESS_PRECOMPILERS
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
The YUI compressor filesystem path.
|
|
|
|
|
|
|
|
|
|
:Default: ``()``
|
|
|
|
|
.. attribute:: COMPRESS_YUI_JS_ARGUMENTS
|
|
|
|
|
|
|
|
|
|
An iterable of two-tuples whose first item is the mimetype of the files or
|
|
|
|
|
hunks you want to compile with the command specified as the second item:
|
|
|
|
|
The arguments passed to the compressor.
|
|
|
|
|
|
|
|
|
|
#. mimetype
|
|
|
|
|
The mimetype of the file or inline code should that should be compiled.
|
|
|
|
|
.. _rJSmin: http://opensource.perlig.de/rjsmin/
|
|
|
|
|
.. _`Google Closure compiler`: http://code.google.com/closure/compiler/
|
|
|
|
|
.. _`YUI compressor`: http://developer.yahoo.com/yui/compressor/
|
|
|
|
|
.. _`Slim It`: http://slimit.org/
|
|
|
|
|
|
|
|
|
|
#. command
|
|
|
|
|
The command to call on each of the files. Modern Python string
|
|
|
|
|
formatting will be provided for the two placeholders ``{infile}`` and
|
|
|
|
|
``{outfile}`` whose existence in the command string also triggers the
|
|
|
|
|
actual creation of those temporary files. If not given in the command
|
|
|
|
|
string, Django Compressor will use ``stdin`` and ``stdout`` respectively
|
|
|
|
|
instead.
|
|
|
|
|
.. attribute:: COMPRESS_PRECOMPILERS
|
|
|
|
|
|
|
|
|
|
Example::
|
|
|
|
|
:Default: ``()``
|
|
|
|
|
|
|
|
|
|
COMPRESS_PRECOMPILERS = (
|
|
|
|
|
('text/coffeescript', 'coffee --compile --stdio'),
|
|
|
|
|
('text/less', 'lessc {infile} {outfile}'),
|
|
|
|
|
('text/x-sass', 'sass {infile} {outfile}'),
|
|
|
|
|
('text/x-scss', 'sass --scss {infile} {outfile}'),
|
|
|
|
|
)
|
|
|
|
|
An iterable of two-tuples whose first item is the mimetype of the files or
|
|
|
|
|
hunks you want to compile with the command specified as the second item:
|
|
|
|
|
|
|
|
|
|
With that setting (and CoffeeScript_ installed), you could add the following
|
|
|
|
|
code to your templates:
|
|
|
|
|
#. mimetype
|
|
|
|
|
The mimetype of the file or inline code should that should be compiled.
|
|
|
|
|
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
#. command
|
|
|
|
|
The command to call on each of the files. Modern Python string
|
|
|
|
|
formatting will be provided for the two placeholders ``{infile}`` and
|
|
|
|
|
``{outfile}`` whose existence in the command string also triggers the
|
|
|
|
|
actual creation of those temporary files. If not given in the command
|
|
|
|
|
string, Django Compressor will use ``stdin`` and ``stdout`` respectively
|
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
{% load compress %}
|
|
|
|
|
Example::
|
|
|
|
|
|
|
|
|
|
{% compress js %}
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8" src="/static/js/awesome.coffee" />
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8">
|
|
|
|
|
# Functions:
|
|
|
|
|
square = (x) -> x * x
|
|
|
|
|
</script>
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
COMPRESS_PRECOMPILERS = (
|
|
|
|
|
('text/coffeescript', 'coffee --compile --stdio'),
|
|
|
|
|
('text/less', 'lessc {infile} {outfile}'),
|
|
|
|
|
('text/x-sass', 'sass {infile} {outfile}'),
|
|
|
|
|
('text/x-scss', 'sass --scss {infile} {outfile}'),
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
This would give you something like this::
|
|
|
|
|
With that setting (and CoffeeScript_ installed), you could add the following
|
|
|
|
|
code to your templates:
|
|
|
|
|
|
|
|
|
|
<script type="text/javascript" src="/static/CACHE/js/8dd1a2872443.js" charset="utf-8"></script>
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
|
|
|
|
|
The same works for less_, too:
|
|
|
|
|
{% load compress %}
|
|
|
|
|
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
{% compress js %}
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8" src="/static/js/awesome.coffee" />
|
|
|
|
|
<script type="text/coffeescript" charset="utf-8">
|
|
|
|
|
# Functions:
|
|
|
|
|
square = (x) -> x * x
|
|
|
|
|
</script>
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
|
|
|
|
|
{% load compress %}
|
|
|
|
|
This would give you something like this::
|
|
|
|
|
|
|
|
|
|
{% compress css %}
|
|
|
|
|
<link type="text/less" rel="stylesheet" href="/static/css/styles.less" charset="utf-8">
|
|
|
|
|
<style type="text/less">
|
|
|
|
|
@color: #4D926F;
|
|
|
|
|
<script type="text/javascript" src="/static/CACHE/js/8dd1a2872443.js" charset="utf-8"></script>
|
|
|
|
|
|
|
|
|
|
#header {
|
|
|
|
|
color: @color;
|
|
|
|
|
}
|
|
|
|
|
</style>
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
The same works for less_, too:
|
|
|
|
|
|
|
|
|
|
Which would be rendered something like::
|
|
|
|
|
.. code-block:: django
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" href="/static/CACHE/css/8ccf8d877f18.css" type="text/css" charset="utf-8">
|
|
|
|
|
{% load compress %}
|
|
|
|
|
|
|
|
|
|
.. _less: http://lesscss.org/
|
|
|
|
|
.. _CoffeeScript: http://jashkenas.github.com/coffee-script/
|
|
|
|
|
{% compress css %}
|
|
|
|
|
<link type="text/less" rel="stylesheet" href="/static/css/styles.less" charset="utf-8">
|
|
|
|
|
<style type="text/less">
|
|
|
|
|
@color: #4D926F;
|
|
|
|
|
|
|
|
|
|
.. _compress_storage:
|
|
|
|
|
#header {
|
|
|
|
|
color: @color;
|
|
|
|
|
}
|
|
|
|
|
</style>
|
|
|
|
|
{% endcompress %}
|
|
|
|
|
|
|
|
|
|
COMPRESS_STORAGE
|
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
Which would be rendered something like::
|
|
|
|
|
|
|
|
|
|
:Default: ``'compressor.storage.CompressorFileStorage'``
|
|
|
|
|
<link rel="stylesheet" href="/static/CACHE/css/8ccf8d877f18.css" type="text/css" charset="utf-8">
|
|
|
|
|
|
|
|
|
|
The dotted path to a Django Storage backend to be used to save the
|
|
|
|
|
compressed files.
|
|
|
|
|
.. _less: http://lesscss.org/
|
|
|
|
|
.. _CoffeeScript: http://jashkenas.github.com/coffee-script/
|
|
|
|
|
|
|
|
|
|
Django Compressor ships with one additional storage backend:
|
|
|
|
|
.. attribute:: COMPRESS_STORAGE
|
|
|
|
|
|
|
|
|
|
* ``'compressor.storage.GzipCompressorFileStorage'``
|
|
|
|
|
:Default: ``'compressor.storage.CompressorFileStorage'``
|
|
|
|
|
|
|
|
|
|
A subclass of the default storage backend, which will additionally
|
|
|
|
|
create ``*.gz`` files of each of the compressed files.
|
|
|
|
|
The dotted path to a Django Storage backend to be used to save the
|
|
|
|
|
compressed files.
|
|
|
|
|
|
|
|
|
|
.. _compress_parser:
|
|
|
|
|
Django Compressor ships with one additional storage backend:
|
|
|
|
|
|
|
|
|
|
COMPRESS_PARSER
|
|
|
|
|
^^^^^^^^^^^^^^^
|
|
|
|
|
* ``'compressor.storage.GzipCompressorFileStorage'``
|
|
|
|
|
|
|
|
|
|
:Default: ``'compressor.parser.AutoSelectParser'``
|
|
|
|
|
A subclass of the default storage backend, which will additionally
|
|
|
|
|
create ``*.gz`` files of each of the compressed files.
|
|
|
|
|
|
|
|
|
|
The backend to use when parsing the JavaScript or Stylesheet files. The
|
|
|
|
|
``AutoSelectParser`` picks the ``lxml`` based parser when available, and falls
|
|
|
|
|
back to ``HtmlParser`` if ``lxml`` is not available.
|
|
|
|
|
.. attribute:: COMPRESS_PARSER
|
|
|
|
|
|
|
|
|
|
``LxmlParser`` is the fastest available parser, but ``HtmlParser`` is not much
|
|
|
|
|
slower. ``AutoSelectParser`` adds a slight overhead, but in most cases it
|
|
|
|
|
won't be necessary to change the default parser.
|
|
|
|
|
:Default: ``'compressor.parser.AutoSelectParser'``
|
|
|
|
|
|
|
|
|
|
The other two included parsers are considerably slower and should only be
|
|
|
|
|
used if absolutely necessary.
|
|
|
|
|
The backend to use when parsing the JavaScript or Stylesheet files. The
|
|
|
|
|
``AutoSelectParser`` picks the ``lxml`` based parser when available, and falls
|
|
|
|
|
back to ``HtmlParser`` if ``lxml`` is not available.
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
``LxmlParser`` is the fastest available parser, but ``HtmlParser`` is not much
|
|
|
|
|
slower. ``AutoSelectParser`` adds a slight overhead, but in most cases it
|
|
|
|
|
won't be necessary to change the default parser.
|
|
|
|
|
|
|
|
|
|
In some cases the ``compressor.parser.HtmlParser`` parser isn't able to
|
|
|
|
|
parse invalid HTML in JavaScript or CSS content. As a workaround you
|
|
|
|
|
should use one of the more forgiving parsers, e.g. the
|
|
|
|
|
``BeautifulSoupParser``.
|
|
|
|
|
The other two included parsers are considerably slower and should only be
|
|
|
|
|
used if absolutely necessary.
|
|
|
|
|
|
|
|
|
|
The backends included in Django Compressor:
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
|
|
|
- ``compressor.parser.AutoSelectParser``
|
|
|
|
|
- ``compressor.parser.LxmlParser``
|
|
|
|
|
- ``compressor.parser.HtmlParser``
|
|
|
|
|
- ``compressor.parser.BeautifulSoupParser``
|
|
|
|
|
- ``compressor.parser.Html5LibParser``
|
|
|
|
|
In some cases the ``compressor.parser.HtmlParser`` parser isn't able to
|
|
|
|
|
parse invalid HTML in JavaScript or CSS content. As a workaround you
|
|
|
|
|
should use one of the more forgiving parsers, e.g. the
|
|
|
|
|
``BeautifulSoupParser``.
|
|
|
|
|
|
|
|
|
|
See :ref:`dependencies` for more info about the packages you need
|
|
|
|
|
for each parser.
|
|
|
|
|
The backends included in Django Compressor:
|
|
|
|
|
|
|
|
|
|
.. _compress_cache_backend:
|
|
|
|
|
- ``compressor.parser.AutoSelectParser``
|
|
|
|
|
- ``compressor.parser.LxmlParser``
|
|
|
|
|
- ``compressor.parser.HtmlParser``
|
|
|
|
|
- ``compressor.parser.BeautifulSoupParser``
|
|
|
|
|
- ``compressor.parser.Html5LibParser``
|
|
|
|
|
|
|
|
|
|
COMPRESS_CACHE_BACKEND
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
See :ref:`dependencies` for more info about the packages you need
|
|
|
|
|
for each parser.
|
|
|
|
|
|
|
|
|
|
:Default: ``"default"`` or ``CACHE_BACKEND``
|
|
|
|
|
Caching settings
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
The backend to use for caching, in case you want to use a different cache
|
|
|
|
|
backend for Django Compressor.
|
|
|
|
|
.. attribute:: COMPRESS_CACHE_BACKEND
|
|
|
|
|
|
|
|
|
|
If you have set the ``CACHES`` setting (new in Django 1.3),
|
|
|
|
|
``COMPRESS_CACHE_BACKEND`` defaults to ``"default"``, which is the alias for
|
|
|
|
|
the default cache backend. You can set it to a different alias that you have
|
|
|
|
|
configured in your ``CACHES`` setting.
|
|
|
|
|
:Default: ``"default"`` or ``CACHE_BACKEND``
|
|
|
|
|
|
|
|
|
|
If you have not set ``CACHES`` and are using the old ``CACHE_BACKEND``
|
|
|
|
|
setting, ``COMPRESS_CACHE_BACKEND`` defaults to the ``CACHE_BACKEND`` setting.
|
|
|
|
|
The backend to use for caching, in case you want to use a different cache
|
|
|
|
|
backend for Django Compressor.
|
|
|
|
|
|
|
|
|
|
COMPRESS_REBUILD_TIMEOUT
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
If you have set the ``CACHES`` setting (new in Django 1.3),
|
|
|
|
|
``COMPRESS_CACHE_BACKEND`` defaults to ``"default"``, which is the alias for
|
|
|
|
|
the default cache backend. You can set it to a different alias that you have
|
|
|
|
|
configured in your ``CACHES`` setting.
|
|
|
|
|
|
|
|
|
|
:Default: ``2592000`` (30 days in seconds)
|
|
|
|
|
If you have not set ``CACHES`` and are using the old ``CACHE_BACKEND``
|
|
|
|
|
setting, ``COMPRESS_CACHE_BACKEND`` defaults to the ``CACHE_BACKEND`` setting.
|
|
|
|
|
|
|
|
|
|
The period of time after which the compressed files are rebuilt even if
|
|
|
|
|
no file changes are detected.
|
|
|
|
|
.. attribute:: COMPRESS_REBUILD_TIMEOUT
|
|
|
|
|
|
|
|
|
|
COMPRESS_MINT_DELAY
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
:Default: ``2592000`` (30 days in seconds)
|
|
|
|
|
|
|
|
|
|
:Default: ``30`` (seconds)
|
|
|
|
|
The period of time after which the compressed files are rebuilt even if
|
|
|
|
|
no file changes are detected.
|
|
|
|
|
|
|
|
|
|
The upper bound on how long any compression should take to run. Prevents
|
|
|
|
|
dog piling, should be a lot smaller than COMPRESS_REBUILD_TIMEOUT_.
|
|
|
|
|
.. attribute:: COMPRESS_MINT_DELAY
|
|
|
|
|
|
|
|
|
|
COMPRESS_MTIME_DELAY
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
:Default: ``30`` (seconds)
|
|
|
|
|
|
|
|
|
|
:Default: ``10``
|
|
|
|
|
The upper bound on how long any compression should take to run. Prevents
|
|
|
|
|
dog piling, should be a lot smaller than
|
|
|
|
|
:attr:`~django.conf.settings.COMPRESS_REBUILD_TIMEOUT`.
|
|
|
|
|
|
|
|
|
|
The amount of time (in seconds) to cache the modification timestamp of a
|
|
|
|
|
file. Disabled by default. Should be smaller than COMPRESS_REBUILD_TIMEOUT_
|
|
|
|
|
and COMPRESS_MINT_DELAY_.
|
|
|
|
|
.. attribute:: COMPRESS_MTIME_DELAY
|
|
|
|
|
|
|
|
|
|
COMPRESS_DEBUG_TOGGLE
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
:Default: ``10``
|
|
|
|
|
|
|
|
|
|
:Default: None
|
|
|
|
|
The amount of time (in seconds) to cache the modification timestamp of a
|
|
|
|
|
file. Disabled by default. Should be smaller than
|
|
|
|
|
:attr:`django.conf.settings.COMPRESS_REBUILD_TIMEOUT` and
|
|
|
|
|
:attr:`django.conf.settings.COMPRESS_MINT_DELAY`.
|
|
|
|
|
|
|
|
|
|
The name of the GET variable that toggles the debug mode and prevents Django
|
|
|
|
|
Compressor from performing the actual compression. Only useful for debugging.
|
|
|
|
|
.. attribute:: COMPRESS_DEBUG_TOGGLE
|
|
|
|
|
|
|
|
|
|
.. warning::
|
|
|
|
|
:Default: None
|
|
|
|
|
|
|
|
|
|
Don't use this option in production!
|
|
|
|
|
The name of the GET variable that toggles the debug mode and prevents Django
|
|
|
|
|
Compressor from performing the actual compression. Only useful for debugging.
|
|
|
|
|
|
|
|
|
|
An easy convention is to only set it depending on the ``DEBUG`` setting::
|
|
|
|
|
.. warning::
|
|
|
|
|
|
|
|
|
|
if DEBUG:
|
|
|
|
|
COMPRESS_DEBUG_TOGGLE = 'whatever'
|
|
|
|
|
Don't use this option in production!
|
|
|
|
|
|
|
|
|
|
.. note::
|
|
|
|
|
An easy convention is to only set it depending on the ``DEBUG`` setting::
|
|
|
|
|
|
|
|
|
|
This only works for pages that are rendered using the RequestContext_
|
|
|
|
|
and the ``django.core.context_processors.request`` context processor.
|
|
|
|
|
if DEBUG:
|
|
|
|
|
COMPRESS_DEBUG_TOGGLE = 'whatever'
|
|
|
|
|
|
|
|
|
|
.. _RequestContext: http://docs.djangoproject.com/en/dev/ref/templates/api/#django.template.RequestContext
|
|
|
|
|
.. note::
|
|
|
|
|
|
|
|
|
|
.. _compress_offline:
|
|
|
|
|
This only works for pages that are rendered using the RequestContext_
|
|
|
|
|
and the ``django.core.context_processors.request`` context processor.
|
|
|
|
|
|
|
|
|
|
COMPRESS_OFFLINE
|
|
|
|
|
^^^^^^^^^^^^^^^^
|
|
|
|
|
.. _RequestContext: http://docs.djangoproject.com/en/dev/ref/templates/api/#django.template.RequestContext
|
|
|
|
|
|
|
|
|
|
:Default: ``False``
|
|
|
|
|
Offline settings
|
|
|
|
|
----------------
|
|
|
|
|
|
|
|
|
|
Boolean that decides if compression should also be done outside of the
|
|
|
|
|
request/response loop -- independent from user requests. This allows to
|
|
|
|
|
pre-compress CSS and JavaScript files and works just like the automatic
|
|
|
|
|
compression with the ``{% compress %}`` tag.
|
|
|
|
|
.. attribute:: COMPRESS_OFFLINE
|
|
|
|
|
|
|
|
|
|
.. _compress_offline_timeout:
|
|
|
|
|
:Default: ``False``
|
|
|
|
|
|
|
|
|
|
COMPRESS_OFFLINE_TIMEOUT
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
Boolean that decides if compression should also be done outside of the
|
|
|
|
|
request/response loop -- independent from user requests. This allows to
|
|
|
|
|
pre-compress CSS and JavaScript files and works just like the automatic
|
|
|
|
|
compression with the ``{% compress %}`` tag.
|
|
|
|
|
|
|
|
|
|
:Default: ``31536000`` (1 year in seconds)
|
|
|
|
|
.. attribute:: COMPRESS_OFFLINE_TIMEOUT
|
|
|
|
|
|
|
|
|
|
The period of time with which the ``compress`` management command stores
|
|
|
|
|
the pre-compressed the contents of ``{% compress %}`` template tags in
|
|
|
|
|
the cache.
|
|
|
|
|
:Default: ``31536000`` (1 year in seconds)
|
|
|
|
|
|
|
|
|
|
.. _compress_offline_context:
|
|
|
|
|
The period of time with which the ``compress`` management command stores
|
|
|
|
|
the pre-compressed the contents of ``{% compress %}`` template tags in
|
|
|
|
|
the cache.
|
|
|
|
|
|
|
|
|
|
COMPRESS_OFFLINE_CONTEXT
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
.. attribute:: COMPRESS_OFFLINE_CONTEXT
|
|
|
|
|
|
|
|
|
|
:Default: ``{'MEDIA_URL': settings.MEDIA_URL}``
|
|
|
|
|
:Default: ``{'MEDIA_URL': settings.MEDIA_URL}``
|
|
|
|
|
|
|
|
|
|
The context to be used by the ``compress`` management command when rendering
|
|
|
|
|
the contents of ``{% compress %}`` template tags and saving the result in the
|
|
|
|
|
offline cache.
|
|
|
|
|
The context to be used by the ``compress`` management command when rendering
|
|
|
|
|
the contents of ``{% compress %}`` template tags and saving the result in the
|
|
|
|
|
offline cache.
|
|
|
|
|
|
|
|
|
|
If available, the ``STATIC_URL`` setting is also added to the context.
|
|
|
|
|
If available, the ``STATIC_URL`` setting is also added to the context.
|
|
|
|
|
|
|
|
|
|
.. _compress_offline_manifest:
|
|
|
|
|
.. attribute:: COMPRESS_OFFLINE_MANIFEST
|
|
|
|
|
|
|
|
|
|
COMPRESS_OFFLINE_MANIFEST
|
|
|
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
|
:Default: ``manifest.json``
|
|
|
|
|
|
|
|
|
|
:Default: ``manifest.json``
|
|
|
|
|
|
|
|
|
|
The name of the file to be used for saving the names of the files compressed
|
|
|
|
|
offline.
|
|
|
|
|
The name of the file to be used for saving the names of the files compressed
|
|
|
|
|
offline.
|
|
|
|
|
|
Jannis Leidel