grunt-ruby-haml/README.md

74 lines
2.0 KiB
Markdown
Raw Normal View History

2013-02-06 18:08:33 +00:00
# grunt-ruby-haml
2013-02-06 18:27:02 +00:00
Compile your HTML templates using the Ruby HAML command-line compiler
2013-02-06 18:08:33 +00:00
## WHAT!? WHY!?!?!?
Because I like underscore, and underscore templates. They come free
with Backbone. And Ruby's HAML treats them without abusing them.
It's not a great solution, but it's better than trying to write yet
another HAML parser.
And before you get me started on Jade, or Mustache, or whatever:
forget it. Jade is a big learning curve for little reward, and the
rest are templating languages in their own right.
## Getting Started
Make sure you have Ruby and Haml available in you $PATH.
Install this grunt plugin next to your project's [grunt.js
gruntfile][getting_started] with: `npm install grunt-ruby-haml`
Then add this line to your project's `grunt.js` gruntfile:
```javascript
grunt.loadNpmTasks('grunt-ruby-haml');
```
## Documentation
You'll need to install `grunt-ruby-haml`:
npm install grunt-ruby-haml
Then modify your `Gruntfile.js` file by adding the following line:
grunt.loadNpmTasks('grunt-ruby-haml');
Then add some configuration for the plugin like so:
grunt.initConfig({
...
2013-02-06 18:11:42 +00:00
rubyHaml: {
2013-02-06 18:08:33 +00:00
app: {
files: {
"public/index.html": "src/index.haml"
}
options: {
templatize: False
}
}
},
...
});
2013-02-06 18:11:42 +00:00
Then just run `grunt rubyHaml` and enjoy!
2013-02-06 18:08:33 +00:00
Ruby-HAML will, by default, generate HTML. With the 'templatize'
option set to True, it will instead spit out an underscore template
ready to be rendered, wrapped in an AMD-compliant define() call. This
may be useful to some of you who want to use the output of the HAML
engine as a pre-parsed underscore template.
## 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
0.0.1 - Just what I've always run. Don't expect miracles
## License
Copyright (c) 2013 Elf M. Sternberg
Licensed under the MIT license.