grunt-compass-multiple

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

grunt-compass-multiple

★ 23 Open GitHub ↗

at grunt, compile compass files at multi threads.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![build status](https://secure.travis-ci.org/jharding/grunt-exec.png)](http://travis-ci.org/jharding/grunt-exec)
grunt-compass-multiple
==========

> Grunt plugin for compiling compass files at multi threads.

Getting Started
---------------

This plugin requires Grunt ~0.4.0

Install this grunt plugin next to your project's [grunt.js gruntfile][getting_started] with: `npm install grunt-compass-multiple`

Then add this line to your project's `grunt.js` gruntfile:

```javascript
grunt.loadNpmTasks('grunt-compass-multiple');
```

[grunt]: https://github.com/cowboy/grunt
[getting_started]: https://github.com/cowboy/grunt/blob/master/docs/getting_started.md

Documentation
-------------

This plugin slove the problem of compass slow compile.

This provides you to compass multi threads compiling, so you can develop faster.

the statement below is how to use this plugin.

### Example1

```javascript
grunt.initConfig({

compassMultiple: {
    options : {
      // if you need, you can set options.
      environment: 'production',
      outputStyle: 'compressed',
      javascriptsDir: './js',
      imagesDir: './image',
      fontsDir: './font',
      importPath: './css/framework',
      relativeAssets: true,
      time: true
    },

// you can specify compiling target as options.sassDir, and output dir as options.cssDir.
    // At now, you can only set sassDir and cssDir options.
    common : {
      options: {
        // every compile needs sassDir and cssDir.
        sassDir: 'page/css/cmn/',
        cssDir: '../static/page/css/cmn/'
      }
    }
  }
});
```

### Example2(use multiple options)
you can set multiple sassDir and cssDir for compiling.
```javascript
grunt.initConfig({

// multiple option provides you to compile multi sassDir.
    all: {
      options: {
        multiple: [
          {
          sassDir: 'page/css/cmn/',
          cssDir: '../static/page/css/cmn/'
          },{
          sassDir: 'page/css/orgn/scss',
          cssDir: '../static/page/css/orgn/'
          }
        ]
      }
    }
  }
});
```

### Example3(use config.rb)
You can use config.rb for build setting. Sample is below.

```javascript
grunt.initConfig({

compassMultiple: {
    options : {
      // you can use config.rb for build setting.
      config: 'config.rb',
      // sassDir must be set, for identify compiling targets.
      sassDir: 'page/css/orgn/scss'
    },

// compile task. no need any options.
    common : {},
  }
});
```

### Example4(use sassFiles options)
You can identify compile targets files, if you use sassFiles option.

```javascript
grunt.initConfig({

compassMultiple: {
      options : {
        javascriptsDir: 'js',
        imagesDir: 'img',
      },

// you can set compile target sass files at sassFiles.
      // and you must be set sassDir for compiling option. This is compass command restriction.
      sassFilesTest: {
        options: {
          sassDir: 'css3/scss',
          sassFiles: ['css3/scss/sample*.scss', 'css3/scss/hoge.scss'],
          cssDir: ['css3/css'],
        }
      }
    },
});
```

License
-------

grunt-compass-multiple

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README