andrewjanssen / handlebars-rails Goto Github PK

Use the awesome Handlebars.js both server- and client-side.

DRY. That's why.

The easiest way to get a current distribution of handlebars is to download it from https://github.com/wycats/handlebars.js/downloads.

First, grab the copy of handlebars you are using and copy it into vendor/javascripts/handlebars.js. If you want, you can symlink it from your public directory.

In app/controllers/blogs_controller.rb:

BlogsController
  def show
    @blog = Blog.find(params[:id])
  end
end

In app/views/blogs/show.html.hbs:

<article>
  <header>
    <h1>{{{ blog/title }}}</h1>
  </header>
  {{{ blog/body }}}
  <footer>
    by {{{ link_to blog/author/name blog/author }}}
</article>

• Template line numbers may not match stack trace line numbers. This will be resolved upstream.
• Block helpers do not currently work.

Rails returns HTML-safe strings, but the string-safety information isn't passed into Handlebars, so Handlebars re-escapes the content. To get around this, use the triple-stash ({{{ ... }}}) when using a Rails helper. See issue 2.

Rails helpers obviously do not exist in the client-side JS context. This means that if you use {{{ link_to ... }}}, it can only be run server-side. The solution is to implement a minimal link_to in the client-side. See issue 4 and issue 5.

Yehuda Katz did all the heavy lifting to get this off the ground, both in terms of writing Handlebars.js and the template handler here. Additional huge props to Charles Lowell for therubyracer, a sine qua non for this project.