A Django finder that compiles Sass files
Project description
Django Sass Finder
A static files finder for Django that compiles Sass files
Installation
WARNING: MAKE SURE YOU HAVE NO SASS PACKAGES INSTALLED (other than libsass)!
Run pip install django_sass_finder
to add this module to your virtualenv,
then add the finder to the list your static file finders as follows:
STATICFILES_FINDERS = [
# add the default Django finders as this setting will override the default
'django.contrib.staticfiles.finders.FileSystemFinder',
'django.contrib.staticfiles.finders.AppDirectoriesFinder',
# our finder
'django_sass_finder.finders.ScssFinder',
]
There is no need to add django_sass_finder into settings.INSTALLED_APPS
.
The following additional (with examples) settings are used and required by this staticfiles finder:
BASE_DIR = ...
SCSS_ROOT = BASE_DIR / 'scss' # where the .scss files are sourced
SCSS_COMPILE = [ # a list of filename pattern to search for within SCSS_ROOT
'site.scss', # default is **/*,css (all scss source files in and below SCSS_ROOT)
'admin/admin.scss',
]
SCSS_INCLUDE_PATHS = [ # optional: scss compiler include paths (default = empty)
BASE_DIR / 'node_modules'
]
CSS_STYLE = 'compressed' # optional: output format 'nested', 'expanded','compact','compressed'
CSS_MAP = True # optional: generate a source map
CSS_COMPILE_DIR = BASE_DIR / 'static' / 'css' # The target directories for the compiled .css
STATICFILES_ROOT = [ # this should be at or above the CSS_COMPILE_DIR
BASE_DIR / 'static' # but targetting {app}/static should also work
]
BASE_DIR
and variants above are pathlib.Path
objects, but path strings can also be used.
Usage
This module dynamically compiles to target .css files, and recompiles them on demand whenever they are updated.
The collectstatic
management command compiles these, and lets the FilesystemFinder
transfer
them to STATIC_ROOT. The development server is perfectly able to serve these from
STATICFILES_ROOT without the need to collectstatic
.
License
This package is licensed under the MIT license.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_sass_finder-2.0.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5fc14bdbfa23a5f3ff2f5fe8eb0b777910fecd64644f339f6eac724981515283 |
|
MD5 | 4c92290509426881d3f90133d64f2491 |
|
BLAKE2b-256 | 94c4199b2fcd6039e2057c23dcd9f151b79e22a74a6178e744a616a060dfcd5b |