== What is Blender?
Blender is like ant or make for the front-end. It aggregates and compresses
CSS and/or JavaScript assets for a site into efficient, production-ready files.
== Blendfile
The Blendfile, named blender.yaml by default, is the configuration file that
tells Blender which source files are combined into which output files. The
file uses the YAML format. The output file is listed as hash key and source
files are the hash values as an array. Here is a sample Blendfile:
blender.yaml for boldpx.com
_behavior/_global-min.js:
- _vendor/jquery/jquery.js
- _vendor/shadowbox/src/js/adapter/shadowbox-jquery.js
- _vendor/shadowbox/src/js/shadowbox.js
- _behavior/_global.js
_style/_global-min.css:
- _vendor/shadowbox/src/css/shadowbox.css
- _style/_global/typography.css
- _style/_global/typography-print.css
- _style/_global/colors.css
- _style/_global/colors-print.css
- _style/_global/layout-screen.css
- _style/_global/layout-print.css
== Usage
Usage: blend [options]
-h, --help Show this message
-V, --version Prints Blender's version number
-f, --file FILE Use given Blendfile
-t, --type TYPE Select file type to blend (css, js)
-d, --data Convert url(image.ext) to url(data:) in CSS files EXPERIMENTAL
--force Force blending when source files aren't newer than output files
--yui=YUIOPTS Pass arguments to YUI Compressor
-g, --generate Generate a stub Blendfile
== Examples
In your site directory run 'blend' to minify CSS and JavaScript.
blend
Other examples:
blend -f site/blender.yaml
blend -t css
blend -t css -d
blend --yui='--preserve-semi'
== Installation
To install the rubygem, run the following at the command line:
sudo gem install blender
Java, v1.4 or greater is required
== License
Copyright (c) 2008 Chris Griego
(c) 2008 Blake Elshire
Blender is freely distributable under the terms of an MIT-style license.
For details, see http://www.opensource.org/licenses/mit-license.php