This SASS/SCSS plugin uses the original ruby implementation, which requires installing ruby and the necessary gems. If you would like to use a native node implementation which would be faster (but no support for 3rd party ruby gems like compass etc) then we'd recommend using the nodesass plugin. More info here.
.css.(sass|scss). Make sure that you your files are located in
render) folder as extensions-based rendering happens only inside this folder.
Install this plugin
docpad install sass
For information on customising your plugin configuration you can refer to the DocPad FAQ
Sass and Scss Paths
We automatically detect the path to your sass and scss executables, however sometimes that doesn't work and you will get
ENOENT errors. If our detection fails and you'll have to manually specify the path to your sass and scss executables with the
scssPath config options, more info here.
We automatically detect if you have compass installed, and if you do, then we'll use it. If our detection fails and you want to still use it, then set the
compass option to
true. If you have compass installed but don't want to use it then set the
compass option to
You can set the
outputStyle option to any of the supported output styles. Those being
compressed. By default, we use the
compressed mode for all environments, except the development mode where it is set to
You can set the
requireLibraries option to an array of extra ruby libraries you'd like to include before rendering your sass file. For instance, setting it to
['susy','compass-colors'] will include the Susy and Compass Colors plugins. By default, the value is set to
null indicating we do not include any libaries.
Render Underscore Stylesheets
By default we prevent any SASS/SCSS stylesheets that filename starts with underscore character from being rendered and written to the output directory. This is to follow SASS/SCSS convention that such files are just intended to be included inside out stylesheets, and that they are not meant to be rendered by themselves. If you really want to, you can render the underscore stylesheets by setting the
renderUnderscoreStylesheets option to
true in your plugin's configuration.
If you want to use sourcemaps, set the
sourcemap option to
If you want to use bundler you can set something like this in docpad.coffee:
plugins: sass: scssPath: ['bundle','exec','scss'] sassPath: ['bundle','exec','sass']
ERROR: Cannot load compass.
Install compass again using:
gem install compass --pre
These amazing people are maintaining this project:
No sponsors yet! Will you be the first?
These amazing people have contributed code to this project:
- Andrew Kondratev — view contributions
- Benjamin Lupton — view contributions
- diessica — view contributions
- diessicode — view contributions
- Jan Kolkmeier — view contributions
- jankolkmeier — view contributions
- jking90 — view contributions
- Johannes Troeger
- Merrick Christensen — view contributions
- Marcin Operacz — view contributions
- Neil Taylor — view contributions
- Pat O'Callaghan — view contributions
- Johannes Troeger — view contributions
- Thuong Dinh — view contributions
- Vadim Makeev — view contributions
Unless stated otherwise all works are:
- Copyright © 2012+ Bevry Pty Ltd
and licensed under: