grunt scss selected compile

Compiles css files up on saving. It won't compile all scss files. If you have too many files it saves lot of time. This plugin is same as grunt-contrib-sass but you don't have to specify each and every file in Grunt.js.

Getting Started

This plugin requires Grunt ~0.4.1

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-scss-selected-compile --save-dev

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

grunt.loadNpmTasks('grunt-scss-selected-compile');

The "cs" task

Overview

In your project's Gruntfile, add a section named cs to the data object passed into grunt.initConfig().

grunt.initConfig({
  cs: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
})

Sass task

Run this task with the grunt sass command.

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

Options

trace

Type: Boolean

Show a full traceback on error.

cssDir

Type: string

Adds css destination folder. All compiled files will place in this path.

unixNewlines

Type: Boolean

Force Unix newlines in written files.

check

Type: Boolean

Just check syntax, don't evaluate.

style

Type: String

Output style. Can be nested (default), compact, compressed, or expanded.

precision

Type: Number

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

quiet

Type: Boolean

Silence warnings and status messages during compilation.

compass

Type: Boolean

Make Compass imports available and load project configuration.

debugInfo

Type: Boolean

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

lineNumbers

Type: Boolean

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

The path to put cached Sass files. Defaults to .sass-cache.

noCache

Type: Boolean

Don't cache to sassc files.

bundleExec

Type: Boolean

Run sass with bundle exec: bundle exec sass.

Usage Examples

Example config

grunt.initConfig({
  cs: {
        options: {
            style: 'expanded',
            cssDir: '.tmp/css/'
        },
        files: {
            src: ['<%= yeoman.app %>/css/*.*']
        }
    }
});
 
grunt.loadNpmTasks('grunt-compile-selected');
 
grunt.registerTask('default', ['jshint', 'cs']);

Use it with watch tasks

            coffee: {
                files: ['<%= yeoman.app %>/js/{,*/}*.coffee'],
                tasks: ['coffee:dist']
            },
            coffeeTest: {
                files: ['test/spec/{,*/}*.coffee'],
                tasks: ['coffee:test']
            },
            jade: {
                files: ['<%= yeoman.app %>/template/**/*.jade'],
                tasks: ['jade']
            },
            cs: {
                files: ['<%= yeoman.app %>/css/{,*/}*.{scss,sass}'],
                tasks: ['cs']
            }
        }

Contributing

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Release History

(Nothing yet)