Installation and Setup

• You’ll need to install Compass; this is a Ruby library, so use the gem utility (installed out-of-the-box on most systems):

  $ [sudo] gem install compass --pre

• Then, just use pip or easy_install to install django-compass2 (the dependencies will be handled automatically):

  $ pip install django-compass2 # OR
  $ easy_install django-compass2

• Add 'djcompass' to your INSTALLED_APPS setting.

• In your settings.py file, add the necessary settings. Take a look at the configuration reference below for more information, but here’s a quick example:

  COMPASS_INPUT = PROJECT_ROOT + 'media/sass'
  COMPASS_OUTPUT = PROJECT_ROOT + 'media/css'
  COMPASS_STYLE = 'compact'
  COMPASS_REQUIRES = (
      'ninesixty',  # 960.gs Grid System
  )

• You can now compile your Sass with the management command:

  $ python manage.py compass

Usage

The command-line interface is very simple. To see available options and commands try:

$ python manage.py compass --help

Basically the syntax is as simple as:

$ python manage.py compass <primary_command>

Just compile your Sass into CSS:

$ python manage.py compass
   exists media/css
unchanged media/sass/style.sass

The above command is more or less equivalent to invoking:

compass --sass-dir media/sass --css-dir media/css --output-style compact

Monitor your Sass continuously:

$ python manage.py compass watch
>>> Compass is watching for changes. Press Ctrl-C to Stop.
>>> Change detected to: .../media/sass/style.sass
overwrite media/css/style.css
...

Which is something like:

compass --sass-dir media/sass --css-dir media/css --output-style compact --watch

Configuration Reference