This repository has been archived on 2020-05-08. You can view files and clone it, but cannot push or open issues or pull requests.
understrap/node_modules/grunt-contrib-sass
Holger Koenemann 6e61f36d14 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
..
docs 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
node_modules 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
tasks 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
.jshintrc 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
AUTHORS 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
CHANGELOG 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
CONTRIBUTING.md 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
Gruntfile.js 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
LICENSE-MIT 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
README.md 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00
package.json 0.2.8 Adding Grunt/Grunt SASS task 2015-02-06 09:40:32 +01:00

README.md

grunt-contrib-sass v0.8.1 Build Status: Linux

Compile Sass to CSS

Getting Started

This plugin requires Grunt >=0.4.0

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, you may install this plugin with this command:

npm install grunt-contrib-sass --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-contrib-sass');

Sass task

Run this task with the grunt sass command.

Sass is a preprocessor that adds nested rules, variables, mixins and functions, selector inheritance, and more to CSS. Sass files compile into well-formatted, standard CSS to use in your site or application.

This task requires you to have Ruby and Sass installed. If you're on OS X or Linux you probably already have Ruby installed; test with ruby -v in your terminal. When you've confirmed you have Ruby installed, run gem install sass to install Sass.

Note: Files that begin with "_" are ignored even if they match the globbing pattern. This is done to match the expected Sass partial behaviour.

Options

sourcemap

Type: String
Default: auto

Values:

  • auto - relative paths where possible, file URIs elsewhere
  • file - always absolute file URIs
  • inline - include the source text in the sourcemap
  • none- no sourcemaps

Requires Sass 3.4.0, which can be installed with gem install sass

trace

Type: Boolean
Default: false

Show a full traceback on error.

unixNewlines

Type: Boolean
Default: false on Windows, otherwise true

Force Unix newlines in written files.

check

Type: Boolean
Default: false

Just check the Sass syntax, does not evaluate and write the output.

style

Type: String
Default: nested

Output style. Can be nested, compact, compressed, expanded.

precision

Type: Number
Default: 5

How many digits of precision to use when outputting decimal numbers.

quiet

Type: Boolean
Default: false

Silence warnings and status messages during compilation.

compass

Type: Boolean
Default: false

Make Compass imports available and load project configuration (config.rb located close to the Gruntfile.js).

debugInfo

Type: Boolean
Default: false

Emit extra information in the generated CSS that can be used by the FireSass Firebug plugin.

lineNumbers

Type: Boolean
Default: false

Emit comments in the generated CSS indicating the corresponding source line.

loadPath

Type: String|Array

Add a (or multiple) Sass import path.

require

Type: String|Array

Require a (or multiple) Ruby library before running Sass.

cacheLocation

Type: String
Default: .sass-cache

The path to put cached Sass files.

noCache

Type: Boolean
Default: false

Don't cache to sassc files.

bundleExec

Type: Boolean
Default: false

Run sass with bundle exec: bundle exec sass.

banner

Type: String

Prepend the specified string to the output file. Useful for licensing information.

Can't be used if you use the sourcemap option.

update

Type: Boolean
Default: false

Only compile changed files.

Examples

Example config

grunt.initConfig({
  sass: {                              // Task
    dist: {                            // Target
      options: {                       // Target options
        style: 'expanded'
      },
      files: {                         // Dictionary of files
        'main.css': 'main.scss',       // 'destination': 'source'
        'widgets.css': 'widgets.scss'
      }
    }
  }
});

grunt.loadNpmTasks('grunt-contrib-sass');

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

Compile

grunt.initConfig({
  sass: {
    dist: {
      files: {
        'main.css': 'main.scss'
      }
    }
  }
});

Concat and compile

Instead of concatenating the files, just @import them into another .sass file eg. main.scss.

Compile multiple files

You can specify multiple destination: source items in files.

grunt.initConfig({
  sass: {
    dist: {
      files: {
        'main.css': 'main.scss',
        'widgets.css': 'widgets.scss'
      }
    }
  }
});

Compile files in a directory

Instead of naming all files you want to compile, you can use the expand property allowing you to specify a directory. More information available in the grunt docs - Building the files object dynamically.

grunt.initConfig({
  sass: {
    dist: {
      files: [{
        expand: true,
        cwd: 'styles',
        src: ['*.scss'],
        dest: '../public',
        ext: '.css'
      }]
    }
  }
});

Release History

  • 2014-08-24v0.8.1Fix check option.
  • 2014-08-21v0.8.0Support Sass 3.4 Source Map option. Add update option.
  • 2014-08-09v0.7.4Fix bundleExec option. Fix os.cpus() issue. Log sass command when --verbose flag is set.
  • 2014-03-06v0.7.3Only create empty dest files when they don't already exist.
  • 2014-02-02v0.7.2Fix error reporting when Sass is not available.
  • 2014-01-28v0.7.1Fix regression of Bundler support.
  • 2014-01-26v0.7.0Improve Windows support.
  • 2013-12-10v0.6.0Ignore files where filename have leading underscore.
  • 2013-08-21v0.5.0Add banner option.
  • 2013-07-06v0.4.1Use file.orig.src if file.src does not exist and return early to avoid passing non-existent files to sass binary.
  • 2013-06-30v0.4.0Rewrite task to be able to support Source Maps. Compile Sass files in parallel for better performance.
  • 2013-03-26v0.3.0Add support for bundle exec. Make sure .css files are compiled with SCSS.
  • 2013-02-15v0.2.2First official release for Grunt 0.4.0.
  • 2013-01-25v0.2.2rc7Updating grunt/gruntplugin dependencies to rc7. Changing in-development grunt/gruntplugin dependency versions from tilde version ranges to specific versions.
  • 2013-01-09v0.2.2rc5Updating to work with grunt v0.4.0rc5. Switching to this.files api. Add separator option.
  • 2012-11-05v0.2.0Grunt 0.4 compatibility. Improve error message when Sass binary couldn't be found
  • 2012-10-12v0.1.3Rename grunt-contrib-lib dep to grunt-lib-contrib.
  • 2012-10-08v0.1.2Fix regression for darwin.
  • 2012-10-05v0.1.1Windows support.
  • 2012-09-24v0.1.0Initial release.

Task submitted by Sindre Sorhus

This file was generated on Sun Aug 24 2014 16:51:41.