LESS Processor

This adds support for LESS, the extended CSS dialect.

Usage

Note

You’ll need to install the LESS compiler. See the section on Server-side Usage in the LESS documentation

Ensure that the processor is in the list of enabled processors in settings.py:

STATICFILESPLUS_PROCESSORS = (
    ...
    'staticfilesplus.processors.less.LESSProcessor',
    ...
)

In your templates, link to your LESS files using their post-processed .css extension, not their original .less extension. For example:

/* myapp/static/styles.less */
p {
  color: green;
}
<!-- myapp/templates/base.html -->
...
<link rel="stylesheet" href="{% static 'styles.css' %}" type="text/css"/>
...

Hidden files

The LESS processor ignores all files and directories which start with an underscore.

LESS itself can still @import these files but they will not be individually included in the list of compiled files. This allows you to prevent library files from being compiled as stand-alone files, which will often break anyway if these files rely on variables that have not been defined.

For example, in this case:

/* myapp/static/styles.less */
@import '_lib/base.less';

h1 {
  background-color: blue;
}
/* myapp/static/_lib/base.less */
p {
  color: green;
}
...

The final output would contain a styles.css file (with the imported content of base.less) but no stand-alone _lib/base.css file.

Settings

STATICFILESPLUS_LESS_COMPRESS
Default :the opposite of DEBUG

Passes the --compress flag to the LESS compiler to produce minified output suitable for production.

Read the Docs v: latest
Versions
latest
Downloads
PDF
HTML
Epub
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.