Inline

{% load scss %}

<style>
  {% inlinescss %}
    #header {
      h1 {
        font-size: 26px;
        font-weight: bold;
      }
      p { font-size: 12px;
        a { text-decoration: none;
          &:hover { border-width: 1px }
        }
      }
    }
  {% endinlinescss %}
</style>

renders to

<style>
  #header h1 {
    font-size: 26px;
    font-weight: bold; }
  #header p {
    font-size: 12px; }
    #header p a {
      text-decoration: none; }
      #header p a:hover {
        border-width: 1px; }
</style>

External file

{% load scss %}

<link rel="stylesheet" href="{{ STATIC_URL}}{% scss "path/to/styles.scss" %}" />

renders to

<link rel="stylesheet" href="/media/SCSS_CACHE/path/to/styles-91ce1f66f583.css" />

Note that by default compiled files are saved into SCSS_CACHE folder under your STATIC_ROOT (or MEDIA_ROOT if you have no STATIC_ROOT in your settings). You can change this folder with SCSS_ROOT and SCSS_OUTPUT_DIR settings.

Note that all relative URLs in your stylesheet are converted to absolute URLs using your STATIC_URL setting.

0.6.1

• Use hashlib instead of django.utils.hashcompat which is deprecated in Django 1.5

0.6

• Add staticfiles finder to serve compiled files in dev mode

0.5

• Add SCSS_ROOT setting

0.4.1

• Fix unicodedecodeerror with non ascii in scss file

0.4

• Switch to staticfiles.finders when looking up the files in DEBUG mode.

• Fix the CWD when running scss compiler

0.3

• Add support for lookup in STATICFILES_DIRS

• Allow to use Compass

0.2

• Log SCSS compilation errors

• Fixed bug with paths on Windows

0.1

• Initial release