README.md in handlebars_assets-0.8.2 vs README.md in handlebars_assets-0.9.0
- old
+ new
@@ -4,15 +4,19 @@
Yea, I think so too. That is why I wrote **handlebars_assets**. Give your Handlebars templates their own files (including partials) and have them compiled, compressed, and cached as part of the Rails 3.1 asset pipeline!
Using `sprockets` with Sinatra or another framework? **handlebars_assets** works outside of Rails too (as of v0.2.0)
+# 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
**Please read**
-Because of a serious regression introduced in RC1, `handlebars_assets` is packaged with an edge build of `handlebars.js` (this [commit](https://github.com/wycats/handlebars.js/commit/5e5f0dce9c352f490f1f1e58fd7d0f76dd006cac). 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
@@ -130,21 +134,10 @@
## 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 {{> partial }}
-
-**Important!** Handlebars does not understand nested partials. To support them, partials are named based on their path using `_` instead of `/` (skid => slash). So given:
-
- templates/
- _form.hbs
- contacts/
- _form.hbs
- todos/
- _form.hbs
-
-You will get three partials named `_form`, `_contacts_form`, and `_todos_form`; note that the partials begin with `_`.
+ Invoke a {{> path/to/_partial }}
## Using another version of `handlebars.js`
Occasionally you might need to use a version of `handlebars.js` other than the included version. You can set the `compiler_path` and `compiler` options to use a custom version of `handlebars.js`.