django-scss icondjango-scss 0.5

Django template tags to compile SCSS into CSS
django-scss is a Django app that provides template tags to compile SCSS into CSS from templates. It works with both inline code and extenal files.

Installation

- Add "django_scss" to INSTALLED_APPS setting.
- Make sure that you have sass executable installed. See SASS official site for details.
- Optionally, you can specify the full path to sass executable with SCSS_EXECUTABLE setting. By default it's set to sass.

Example Usage

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 name with SCSS_OUTPUT_DIR setting.

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

Settings

LESS_EXECUTABLE
 Path to SASS compiler executable. Default: "sass".
SCSS_OUTPUT_DIR
 Output directory for compiled external stylesheets. It's relative to STATIC_ROOT. Default: "SCSS_CACHE".
SCSS_USE_CACHE
 Whether to use cache for inline styles. Default: True.
SCSS_CACHE_TIMEOUT
 Cache timeout for inline styles (in seconds). Default: 30 days.
SCSS_MTIME_DELAY
 Cache timeout for reading the modification time of external stylesheets (in seconds). Default: 10 seconds.

last updated on:
November 30th, 2011, 15:20 GMT
price:
FREE!
developed by:
Andrey Fedoseev
license type:
BSD License 
category:
ROOT \ Internet \ Django Plugins

FREE!

In a hurry? Add it to your Download Basket!

user rating

UNRATED
0.0/5
 

0/5

What's New in This Release:
  • Add SCSS_ROOT setting
read full changelog

Add your review!

SUBMIT