grunt-sass-revisited

NOTE: This is a fork of https://github.com/sindresorhus/grunt-sass, with the addition of an issue (with more detailed task configuration example) and a pull request (for output of total files processed at the end of the task) that were rejected by the current maintainer. https://github.com/sindresorhus/grunt-sass/pull/228 https://github.com/sindresorhus/grunt-sass/issues/227

This version is being used in project where more detailed output from the task (total number of stylesheets processed) is helpful. I'll monitor and maintain parity with the original repo.

Original README

(with updated install instructions, and additional task configuration example)

Compile Sass to CSS using node-sass

The issue tracker is disabled because of continuous abuse. Use Stack Overflow for support questions. Issues with the output should be reported on the libsass issue tracker. Install issues should be reported on the node-sass issue tracker. Learn how semver works before opening a PR updating node-sass.

This task uses libsass which is a Sass compiler in C++. In contrast to the original Ruby compiler, this one is much faster, but is missing some features, though improving quickly. It also doesn't support Compass. Check out grunt-contrib-sass if you prefer something more stable, but slower.

Install

$ npm install --save-dev grunt-sass-revisited

Usage

1grunt.initConfig({
2	sass: {
3		options: {
4			sourceMap: true
5		},
6		dist: {
7			files: {
8				'main.css': 'main.scss'
9			}
10		}
11	}
12});

Or...

1grunt.initConfig({
2	sass: {
3		dev: {
4			options: {
5				outputStyle: 'expanded',
6				sourceMap: true
7			},
8			files: [{
9				expand: true,
10				cwd: 'assets/scss',
11				src: ['*.scss'],
12				dest: 'public/css/',
13				ext: '.css'
14			}]
15		},
16		dist: {
17			options: {
18				outputStyle: 'compressed',
19				sourceMap: false
20			},
21			files: [{
22				expand: true,
23				cwd: 'assets/scss',
24				src: ['*.scss'],
25				dest: 'public/css/',
26				ext: '.css'
27			}]
28		}
29	}
30});

grunt.registerTask('default', ['sass']);

Files starting with _ are ignored to match the expected Sass partial behaviour.

Options

See the node-sass options, except for file, outFile, success, error.

The default value for the precision option is 10, so you don't have to change it when using Bootstrap.

License

MIT © Sindre Sorhus, portions © Anthony Bouch as well as other contributors.