v0.8.0

* fixes #25 : adds verbalize, which uses chalk * fixes #24 * fixes #22
assemble · Mar 29, 2014 · b8d41f6 · b8d41f6
1 parent 95144dc
commit b8d41f6
Show file tree

Hide file tree

Showing 14 changed files with 212 additions and 193 deletions.
diff --git a/Gruntfile.js b/Gruntfile.js
@@ -58,6 +58,7 @@ module.exports = function(grunt) {
 
     // Configuration to be run (and then tested).
     less: {
+      options: {debug: false},
       props: {
         options: {
           paths: ['test/fixtures/bootstrap'],
@@ -139,13 +140,11 @@ module.exports = function(grunt) {
       metadata: {
         options: {
           test: 'package.json',
-          // Custom metadata properties
-          metadata: ['test/fixtures/data/*.{yml,json}', 'package.json'],
-          palette: {info: 'red'},
+          // Custom data properties
+          data: ['test/fixtures/data/*.{yml,json}'],
           name: 'Overridden',
           foo: 'callout',
           bar: 'alert',
-          pkg: '<%= pkg %>',
           theme: {
             name: 'Metadata test',
             description: 'Metadata was successfully processed!'
@@ -162,8 +161,12 @@ module.exports = function(grunt) {
       // Should use process lodash templates in less files, using metadata as context
       lodash: {
         options: {
-          paths: ['test/fixtures/bootstrap'],
-          metadata: ["test/fixtures/data/palett.yml"],
+          paths: ['<%= bootstrap %>'],
+          data: ['test/fixtures/data/*.{yml,json}'],
+          theme: {
+            name: 'Metadata test',
+            description: 'Metadata was successfully processed!'
+          },
         },
         files: [
           {expand: true, flatten: true, cwd: 'test/fixtures', src: ['templates-*.less'], dest: 'test/actual/lodash/', ext: '.css'}

diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# assemble-less [![NPM version](https://badge.fury.io/js/assemble-less.png)](http://badge.fury.io/js/assemble-less)  [![Build Status](https://travis-ci.org/assemble/assemble-less.png)](https://travis-ci.org/assemble/assemble-less)
+# assemble-less [![NPM version](https://badge.fury.io/js/assemble-less.png)](http://badge.fury.io/js/assemble-less)  [![Build Status](https://travis-ci.org/assemble/assemble-less.png)](https://travis-ci.org/assemble/assemble-less) 
 
 > Compile LESS to CSS. Adds experimental features that extend Less.js for maintaining UI components and themes. From Jon Schlinkert, core team member of Less.js.
 
@@ -20,7 +20,6 @@ Once the plugin has been installed, it may be enabled inside your Gruntfile with
 grunt.loadNpmTasks('assemble-less');
 ```
 
-
 ## Less task
 _Run this task with the `grunt less` command._
 
@@ -202,6 +201,13 @@ Default: `false`
 
 Rewrite urls to be relative. false: do not modify urls.
 
+### urlArgs
+Type: `String`
+
+Default: none
+
+Appends string to url tokens for cache busting.
+
 ### customFunctions
 Type: `Object`
 
@@ -287,7 +293,6 @@ less: {
 ```
 Useful for testing new features included in a beta or alpha release, or for comparing the compiled results from different versions of Less.js.
 
-
 ### Usage Examples
 > Basic config for compiling LESS to CSS.
 
@@ -402,17 +407,16 @@ less: {
 and a data file, `palette.yml`, with some variables defined:
 
 ```yaml
-## palette.yml
+# palette.yml
 info:    '#000'
 warning: '#111'
 danger:  '#222'
 success: '#333'
 ```
 
-Then in our LESS file:
+Then in our LESS file, you can use Lo-Dash templates _in LESS variables_:
 
-```scss
-// Use as values to variables
+```less
 @palette-info:    <%= palette.info %>;
 @palette-warning: <%= palette.warning %>;
 
@@ -422,8 +426,11 @@ Then in our LESS file:
 .swatch-warning {
   background: @palette-warning;
 }
+```
 
-// or directly as variables
+Or use the templates _in lieu of LESS variables_:
+
+```less
 .swatch-danger {
   background: <%= palette.danger %>;
 }
@@ -432,18 +439,27 @@ Then in our LESS file:
 }
 ```
 
-
-
 ## Release History
-
- * 2014-01-01   v0.7.0   Update to use the Less.js v1.6.0 API for `banner`, `globalVars` and `modifyVars`.
- * 2013-12-18   v0.6.0   Adds `globalVars` and `modifyVars` options. See readme and Gruntfile for examples. Support `sourceMapURL` Support `outputSourceFiles` Support `sourceMapFilename`, `sourceMapBasepath` and `sourceMapRootpath` Upgrade to LESS 1.5 Support `strictUnits` option Support sourceMap option Add `customFunctions` option for defining custom functions within LESS Output the source file name on error yuicompress option now cleancss (Less changed underlying dependency)
- * 2013-07-30   v0.5.0   Completely refactored the plugin based on grunt-contrib-less. Add examples for all features to Gruntfile. Removed the concat feature. You can now use `.lessrc` or `.lessrc.yml` for externalizing task options. New `stripBanners` option
- * 2013-06-13   v0.4.7   Cleaned up a lot of the Gruntfile. Examples are more clear. New `import` option for prepending import statements to LESS files before compiling. New `banner` option for adding banners to generated CSS files.
- * 2013-03-17   v0.3.0   New option to specify the version of less.js to use for compiling to CSS.
- * 2013-03-14   v0.2.3   New options from Less.js 1.4.0
- * 2013-02-27   v0.1.0   First commit.
-
+**DATE**       **VERSION**   **CHANGES**                                                                
+* 2013-12-31   v0.7.0        Update to use the Less.js v1.6.0 API for `banner`, `globalVars` and        
+                             `modifyVars`.                                                              
+* 2013-12-17   v0.6.0        Adds `globalVars` and `modifyVars` options. See readme and Gruntfile for   
+                             examples.,Support `sourceMapURL`,Support `outputSourceFiles`,Support       
+                             `sourceMapFilename`, `sourceMapBasepath` and `sourceMapRootpath`,Upgrade to
+                             LESS 1.5 Support `strictUnits` option,Support sourceMap option,Add         
+                             `customFunctions` option for defining custom functions within LESS,Output  
+                             the source file name on error,yuicompress option now cleancss (Less changed
+                             underlying dependency)                                                     
+* 2013-07-29   v0.5.0        Completely refactored the plugin based on grunt-contrib-less.,Add examples 
+                             for all features to Gruntfile.,Removed the concat feature.,You can now use 
+                             `.lessrc` or `.lessrc.yml` for externalizing task options.,New             
+                             `stripBanners` option                                                      
+* 2013-06-12   v0.4.7        Cleaned up a lot of the Gruntfile. Examples are more clear.,New `import`   
+                             option for prepending import statements to LESS files before compiling.,New
+                             `banner` option for adding banners to generated CSS files.                 
+* 2013-03-16   v0.3.0        New option to specify the version of less.js to use for compiling to CSS.  
+* 2013-03-13   v0.2.3        New options from Less.js 1.4.0                                             
+* 2013-02-26   v0.1.0        First commit.                                                              
 
 ## Authors
 This project is a fork of the popular [grunt-contrib-less](https://github.com/gruntjs/grunt-contrib-less) by [Tyler Kellen](http://goingslowly.com/). Please use that plugin if you require something stable and dependable.
@@ -460,21 +476,16 @@ This fork is maintained by:
 + [github/doowb](https://github.com/doowb)
 + [twitter/doowb](http://twitter.com/jonschlinkert)
 
-
 ## License
-Copyright (c) 2014 Jon Schlinkert, contributors.
+Copyright (c) 2014 Tyler Kellen, contributors.
+Copyright (c) 2014 Jon Schlinkert, contributors.  
 Released under the MIT license
 
 ***
 
-_This file was generated by [grunt-readme](https://github.com/assemble/grunt-readme) on Wednesday, January 1, 2014._
-
-[grunt]: http://gruntjs.com/
-[Getting Started]: https://github.com/gruntjs/grunt/blob/devel/docs/getting_started.md
-[package.json]: https://npmjs.org/doc/json.html
-
+_This file was generated by [grunt-verb](https://github.com/assemble/grunt-verb) on March 29, 2014._
 
-[1]: https://github.com/assemble/assemble-less/blob/master/test/fixtures/data/palette.yml
-[2]: https://github.com/assemble/assemble-less/blob/master/test/fixtures/templates-palette.less
+[1]: ./test/fixtures/data/palette.yml
+[2]: ./test/fixtures/templates-palette.less
 [3]: http://gruntjs.com/api/grunt.template
 [4]: http://gruntjs.com/api/grunt.template#grunt.template.process
diff --git a/docs/README.tmpl.md b/docs/README.tmpl.md
@@ -20,7 +20,7 @@ Task targets, files and options may be specified according to the grunt [Configu
 {%= docs("examples") %}
 
 ## Release History
-{%= include("release-history") %}
+{%= changelog() %}
 
 ## Authors
 This project is a fork of the popular [grunt-contrib-less](https://github.com/gruntjs/grunt-contrib-less) by [Tyler Kellen](http://goingslowly.com/). Please use that plugin if you require something stable and dependable.
@@ -29,14 +29,15 @@ This fork is maintained by:
 {%= contrib("authors") %}
 
 ## License
-{%= copyright %}
-{%= license %}
+Copyright (c) 2014 Tyler Kellen, contributors.
+{%= copyright() %}
+{%= license() %}
 
 ***
 
 {%= include("footer") %}
 
-[1]: https://github.com/assemble/assemble-less/blob/master/test/fixtures/data/palette.yml
-[2]: https://github.com/assemble/assemble-less/blob/master/test/fixtures/templates-palette.less
+[1]: ./test/fixtures/data/palette.yml
+[2]: ./test/fixtures/templates-palette.less
 [3]: http://gruntjs.com/api/grunt.template
 [4]: http://gruntjs.com/api/grunt.template#grunt.template.process
diff --git a/docs/examples.md b/docs/examples.md
@@ -118,10 +118,9 @@ danger:  '#222'
 success: '#333'
 ```
 
-Then in our LESS file:
+Then in our LESS file, you can use Lo-Dash templates _in LESS variables_:
 
-```scss
-// Use as values to variables
+```less
 @palette-info:    <%= palette.info %>;
 @palette-warning: <%= palette.warning %>;
 
@@ -131,12 +130,15 @@ Then in our LESS file:
 .swatch-warning {
   background: @palette-warning;
 }
+```
+
+Or use the templates _in lieu of LESS variables_:
 
-// or directly as variables
+```less
 .swatch-danger {
   background: <%= palette.danger %>;
 }
 .swatch-success {
   background: <%= palette.success %>;
 }
-```
+```
diff --git a/docs/options.md b/docs/options.md
@@ -263,4 +263,4 @@ less: {
   }
 }
 ```
-Useful for testing new features included in a beta or alpha release, or for comparing the compiled results from different versions of Less.js.
+Useful for testing new features included in a beta or alpha release, or for comparing the compiled results from different versions of Less.js.
diff --git a/package.json b/package.json
@@ -38,17 +38,16 @@
     "test": "grunt test"
   },
   "dependencies": {
-    "lodash": "~2.4.1",
-    "less": "~1.6.3",
     "async": "~0.2.10",
-    "chalk": "~0.4.0",
+    "fs-utils": "~0.3.9",
+    "less": "~1.7.0",
+    "lodash": "~2.4.1",
     "maxmin": "~0.1.0",
-    "verbalize": "~0.1.1",
-    "fs-utils": "~0.3.9"
+    "plasma": "~0.1.1",
+    "verbalize": "~0.1.1"
   },
   "devDependencies": {
     "grunt-contrib-clean": "~0.5.0",
-    "matchdep": "~0.3.0",
     "grunt": "~0.4.4",
     "grunt-contrib-jshint": "~0.9.2",
     "grunt-contrib-nodeunit": "~0.3.3",
-Original file line number
+Diff line change
@@ Expand Up / @@ -263,4 +263,4 @@ less: { @@
       }
     }
     ```
-    Useful for testing new features included in a beta or alpha release, or for comparing the compiled results from different versions of Less.js.
+    Useful for testing new features included in a beta or alpha release, or for comparing the compiled results from different versions of Less.js.