README.md in handlebars_assets-0.9.0 vs README.md in handlebars_assets-0.10.0
- old
+ new
@@ -8,15 +8,15 @@
# BREAKING CHANGE IN v0.9.0
My pull request to allow `/` in partials was pulled into Handlebars. The hack that converted partial names to underscored paths (`shared/_time` -> `_shared_time`) is no longer necessary and has been removed. You should change all the partial references in your app when going to v0.9.x.
-## handlebars.js
+## Edge version of handlebars.js
-**Please read**
+*Please read*
-`handlebars_assets` is packaged with an edge build of `handlebars.js` (this [commit](https://github.com/wycats/handlebars.js/commit/a3376e24b1a25f72cf86d1d999bd2ea93fa4dc39). See the section on using another version if that does not work for you.
+`handlebars_assets` is packaged with an edge build of `handlebars.js` (this [commit](https://github.com/wycats/handlebars.js/commit/a3376e24b1a25f72cf86d1d999bd2ea93fa4dc39)). See the section on using another version if that does not work for you.
## Installation with Rails 3.1+
Load `handlebars_assets` in your `Gemfile` as part of the `assets` group
@@ -116,11 +116,11 @@
To compile your templates for use with [Ember.js](http://emberjs.com)
simply turn on the config option
HandlebarsAssets::Config.ember = true
-## `.hamlbars`
+## `.hamlbars` and `.slimbars`
If you name your templates with the extension `.hamlbars`, you can use Haml syntax for your markup! Use `HandlebarsAssets::Config.haml_options` to pass custom options to the Haml rendering engine.
For example, if you have a file `widget.hamlbars` that looks like this:
@@ -130,10 +130,12 @@
The Haml will be pre-processed so that the Handlebars template is basically this:
<h1> {{title}} </h1>
<p> {{body}} </p>
+The same applies to `.slimbars` and the Slim gem. Use `HandlebarsAssets::Config.slim_options` to pass custom options to the Slim rendering engine.
+
## Partials
If you begin the name of the template with an underscore, it will be recognized as a partial. You can invoke partials inside a template using the Handlebars partial syntax:
Invoke a {{> path/to/_partial }}
@@ -174,9 +176,10 @@
* Ken Mayer (@kmayer) : Quick fix for template\_namespace option
* Brad Murray (@wyaeld) : Generic options support
* Blake Williams (@BlakeWilliams) : .handlebars extension
* Tristan Koch (@trkoch) : Strip leading whitespace from compiled templates
* Brian Cardarella (@bcardarella) : Ember support
+* David Lee (@davidlee) : Slim support
# Contributing
Pull requests are welcome! Please do not update the version number.