82 lines
2.9 KiB
Markdown
82 lines
2.9 KiB
Markdown
|
[](http://travis-ci.org/jharding/grunt-less)
|
||
|
|
grunt-less (deprecated)
|
||
|
|
==========
|
||
|
|
|
||
|
|
This grunt plugin has been [deprecated](https://github.com/jharding/grunt-less/issues/15). If you're looking for a less grunt plugin, check out [grunt-contrib-less](https://github.com/gruntjs/grunt-contrib-less).
|
||
|
|
|
||
|
|
Getting Started
|
||
|
|
---------------
|
||
|
|
|
||
|
|
Install this grunt plugin next to your project's [grunt.js gruntfile][getting_started] with: `npm install grunt-less`
|
||
|
|
|
||
|
|
Then add this line to your project's `grunt.js` gruntfile:
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
grunt.loadNpmTasks('grunt-less');
|
||
|
|
```
|
||
|
|
|
||
|
|
[npm_registry_page]: http://search.npmjs.org/#/grunt-less
|
||
|
|
[grunt]: https://github.com/cowboy/grunt
|
||
|
|
[getting_started]: https://github.com/cowboy/grunt/blob/master/docs/getting_started.md
|
||
|
|
|
||
|
|
Documentation
|
||
|
|
-------------
|
||
|
|
|
||
|
|
This task is a [multi task][types_of_tasks], meaning that grunt will automatically iterate over all `less` targets if a target is not specified.
|
||
|
|
|
||
|
|
### Target Properties
|
||
|
|
* __src__*(required)*: The LESS file(s) to be compiled. Can be either a string or an array of strings. If more than one LESS file is provided, each LESS file will be compiled individually and then concatenated together.
|
||
|
|
* __dest__*(required)*: The path where the output from the LESS compilation should be placed. Must be a string as there can be only one destination.
|
||
|
|
* __options__*(optional)*: An object of LESS options. As of right now, the only options supported are `compress` and `yuicompress`.
|
||
|
|
|
||
|
|
### Example
|
||
|
|
|
||
|
|
```javascript
|
||
|
|
// project configuration
|
||
|
|
grunt.initConfig({
|
||
|
|
less: {
|
||
|
|
signup: {
|
||
|
|
src: 'signup.less',
|
||
|
|
dest: 'signup.css'
|
||
|
|
},
|
||
|
|
homepage: {
|
||
|
|
src: ['banner.less', 'app.less'],
|
||
|
|
dest: 'homepage.css',
|
||
|
|
options: {
|
||
|
|
yuicompress: true
|
||
|
|
}
|
||
|
|
},
|
||
|
|
all: {
|
||
|
|
src: '*.less',
|
||
|
|
dest: 'all.css',
|
||
|
|
options: {
|
||
|
|
compress: true
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|
||
|
|
});
|
||
|
|
```
|
||
|
|
|
||
|
|
[types_of_tasks]: https://github.com/cowboy/grunt/blob/master/docs/types_of_tasks.md
|
||
|
|
|
||
|
|
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][grunt].
|
||
|
|
|
||
|
|
Release History
|
||
|
|
---------------
|
||
|
|
* __08/28/2012 - 0.1.6__: Remove grunt as a dependency.
|
||
|
|
* __06/14/2012 - 0.1.5__: Added test cases.
|
||
|
|
* __04/08/2012 - 0.1.4__: Refactored the code to make the helper function more usable.
|
||
|
|
* __04/08/2012 - 0.1.3__: Added `gruntplugin` keyword to be [consistent with other plugins](https://github.com/cowboy/grunt/issues/111).
|
||
|
|
* __04/05/2012 - 0.1.2__: Added support for wildcard patterns and normalizing linefeeds for concatenation.
|
||
|
|
* __04/04/2012 - 0.1.1__: Checking to see if the `src` and `dest` properties are defined. Also now accept a string for `src` and not just an array of strings.
|
||
|
|
* __04/04/2012 - 0.1.0__: Initial release.
|
||
|
|
|
||
|
|
License
|
||
|
|
-------
|
||
|
|
|
||
|
|
Copyright (c) 2012 Jake Harding
|
||
|
|
Licensed under the MIT license.
|