Installation¶
Either check out Pipeline from GitHub or to pull a release off PyPI
pip install django-pipeline
Add ‘pipeline’ to your INSTALLED_APPS
INSTALLED_APPS = ( 'pipeline', )
Use a pipeline storage for STATICFILES_STORAGE
STATICFILES_STORAGE = 'pipeline.storage.PipelineCachedStorage'
Add the PipelineFinder to STATICFILES_FINDERS
STATICFILES_FINDERS = ( 'django.contrib.staticfiles.finders.FileSystemFinder', 'django.contrib.staticfiles.finders.AppDirectoriesFinder', 'pipeline.finders.PipelineFinder', )
Note
You need to use Django>=1.6 to be able to use this version of pipeline.
Upgrading to 1.4¶
To upgrade to pipeline 1.4, you will need to follow theses steps:
Update templates to use the new syntax
{# pipeline<1.4 #} {% load compressed %} {% compressed_js 'group' %} {% compressed_css 'group' %}
{# pipeline=1.4 #} {% load pipeline %} {% javascript 'group' %} {% stylesheet 'group' %}
Add the PipelineFinder to STATICFILES_FINDERS
STATICFILES_FINDERS = ( 'django.contrib.staticfiles.finders.FileSystemFinder', 'django.contrib.staticfiles.finders.AppDirectoriesFinder', 'pipeline.finders.PipelineFinder', )
Recommendations¶
Pipeline’s default CSS and JS compressor is Yuglify. Yuglify wraps UglifyJS and cssmin, applying the default YUI configurations to them. It can be downloaded from: https://github.com/yui/yuglify/.
If you do not install yuglify, make sure to disable the compressor in your settings.