Compile SCSS to CSS using node-sass
Bugs with the output should be submitted on the libsass repo which is the actual compiler.
Make sure to review its issue tracker for known bugs before using this task as it can bite you later on.
This task uses the experimental and superfast Node.js based Sass compiler node-sass (which only compiles .scss files).
Note that node-sass is currently under heavy development and might be unstable, there are also some stuff missing, like a compression option. Check out grunt-contrib-sass (based on Ruby Sass) if you want something stable that also supports the old syntax, but in turn much slower.
If you haven't used grunt before, be sure to check out the Getting Started guide, as it explains how to create a gruntfile as well as install and use grunt plugins. Once you're familiar with that process, install this plugin with this command:
$ npm install --save-dev grunt-sass
Tip: the load-grunt-tasks module makes it easier to load multiple grunt tasks.
See the Gruntfile in this repo for a full example.
Note: Files that begin with "_" are ignored even if they match the globbing pattern. This is done to match the expected Sass partial behaviour.
Import paths to include.
Specify the CSS output style.
Represents the public image path. When using the
image-url() function in a stylesheet, this path will be prepended to the path you supply. eg. Given an
background-image: image-url('image.png') will compile to
Set what debug information is included in the output file. The
map option will create the source map file in your CSS destination.
sourceComments option is set to
sourceMap allows setting a new path context for the referenced Sass files. The source map describes a path from your CSS file location, into the the folder where the Sass files are located. In most occasions this will work out-of-the-box but, in some cases, you may need to set a different output.
You can also compile multiple files into multiple destinations.