grunt-concat-css

> Concat CSS with @import statements at top and relative url preserved.

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:

``shell
npm install grunt-concat-css --save-dev
`

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

`js
grunt.loadNpmTasks('grunt-concat-css');
`

The "concat_css" task

$3


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

`js
grunt.initConfig({
concat_css: {
options: {
// Task-specific options go here.
},
all: {
src: ["/*/.css"],
dest: "styles.css"
},
},
})
`

$3

#### Default Options
By default, all css are concatenated. The only things that happens is that every @import statement are placed at the begininning of the resulting file (as @import statement).

`js
grunt.initConfig({
concat_css: {
options: {},
files: {
'dest/compiled.css': ['src/styles/componentA.css', 'src/styles/componentB.css'],
},
},
})
`

#### Rebase URLs
By specifying assetBaseUrl and baseDir, all the assets will be rebased relative to this project rebase URL.

`js
grunt.initConfig({
concat_css: {
options: {
assetBaseUrl: 'static/assets',
baseDir: 'src/(styles|assets)'
},
files: {
'static/styles.css': ['src/styles//.css', 'src/assets//.css']
}
}
})
``

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

0.3.1:
- REFACTOR: added baseDir to be able to properly compute the baseUrl of an asset

0.3.0:
- Tests added
- REFACTOR: {string} assetBaseUrl option replace {boolean} rebaseUrls

0.2.0:
- UPDATE: rebaseUrls option is disabled by default