cssutil/README.md

A utility tool for building/minifying/concatenating LESS and CSS files

cssutil
=========

A NodeJs package for,

1. Compiling LESS files to css files.
2. Concatenating multiple CSS file into a single one.
3. Minifying css via <a href="https://github.com/GoalSmashers/clean-css" target="_blank">clear-css</a> or <a href="https://github.com/yui/ycssmin" target="_blank">ycssmin</a>

Demo
-------

```js
var cssutil= require('cssutil');

cssutil.build([
    'file1.css',
    'file2.css',
    'less1.less'
], function(e, css) {
    // Do awesome stuff with the css
});

// Now with more knobs and switches!!!
var opts = {
    // Minify the output with clean-css
    // Default: true
    minify: true,
    // Compressor provider
    // Default: 0. 0 = using clean-css , 1 = using ycssmin
    compressProviderId:0,
    // Directories to look for LESS @imports, source file directory is
    // included by default.
    paths: ['.']
};

cssutil.build([
    'file.css',
    'file.less'
], opts, function(e, css) {
    if (e) {
        throw e;
    }

    fs.writeFile('file.min.css', css, function(e) {
        // Continue building
    });
});
```

API Reference
-------------

### `cssutil.build(files, [opts], callback)`

Builds an array of CSS/LESS files, concatenating and minifying them.

`files` is an array of file paths to read. The order of the files is preserved
when concatenating. If a file in `files` is a `.less` file, it will be compiled
and the CSS output will be used.

`opts` is an optional object containing the configuration settings. The
`minify` option will disable minification when it is false. The `paths` option
is an array of paths to look for the files imported by LESS `@import`s. The
source file directory is always added to this when compiling. The `compressProviderId` option will let you choose a css compressor, default is 0(clean-css), you can switch this option to 1 to use ycssmin.

`callback` is a function that will be called with the result. It uses the
normal Node callback signature of `(error, result)`.

License
-------

MIT License. See the `LICENSE` file.