Adds support for the Sass CSS pre-processor to DocPad using node-sass
.sass syntax is not supported by node-sass, so it is not supported by this plugin.
npm install --save docpad-plugin-nodesass
outputStyle is a
String to determine how the final CSS should be rendered. Its value should be one of
'compact' are not currently supported by libsass.
An object that you can use to pass options to node-sass
normal will print comments in the output css that indicates the source file name and line number.
map will produce a sourcemap. Using either of these options instead of
none will prevent you from being able to run any other process on the file (e.g.
debugInfo requires passing an actual file instead of
By default we prevent any SCSS stylesheets that filename starts with underscore character from being rendered and written to the output directory. This is to follow 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.
The node-sass-import-once module speeds up rendering by only importing files once. It also adds a few additional features including automatically importing from
Install it with
npm install --save node-sass-import-once
And then configure it by setting the
nodesass.options.importer to the import-once module:
plugins:nodesass:options:importer: require'node-sass-import-once'importOnce:index: true # @import 'foo'; will load foo/_index.scss if foo is a foldercss: true # @import 'bar'; will import bar.cssbower: true # automatically search bower_components directory for imports
The node-bourbon module includes a simple and lightweight mixin library.
Install it with
npm install --save node-bourbon
And then configure it by setting
nodesass.options.includePaths to the
includePaths provided by the module.