beatrichartz/tilt-handlebars
Handlebars support for Tilt
Tilt::Handlebars
Adds support for Handlebars.rb template
engine to Tilt.
See the Handlebars.js site for syntax.
Installation
Add this line to your application's Gemfile:
gem 'tilt-handlebars'
And then execute:
$ bundle
Or install it yourself as:
$ gem install tilt-handlebars
Usage
Create a Handlebars template file with either a .hbs or .handlebars extension.
Example, in hello.hbs:
Hello, {{name}}. I'm {{emotion}} to meet you.
Then, render the template with Ruby:
require 'tilt/handlebars'
template = Tilt.new('hello.hbs')
puts template.render(nil, name: "Joe", emotion: "happy")Output:
Hello, Joe. I'm happy to meet you.
Partials
Partials are a file that can be loaded into another. For example, you may define a web page with
a master layout (layout.hbs), which includes a header (header.hbs) and footer (footer.hbs).
In this case, header.hbs and footer.hbs would be partials; layout.hbs includes these partials.
layout.hbs:
<html>
<head>...</head>
<body>
{{> header }}
{{ content }}
{{> footer }}
</body>
</html>Notice that you do not include the .hbs file extension in the partial name. Tilt Handlebars
will look for the partial relative to the enclosing file (layout.hbs in this example) with
either a .hbs or .handlebars extension.
Sinatra
Handlebars can be used with Sintra:
require 'sinatra/handlebars'
class MyApp < Sinatra::Base
helpers Sinatra::Handlebars
get "/hello" do
handlebars :hello, locals: {name: 'Joe'}
end
endThis will use the template file named views/hello.hbs.
Partials can also be used with Sinatra. As described previously, partials will be loaded
relative to the enclosing template (e.g., in the views directory).
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature) - Add tests, preferrably using Minitest::Spec for consistency.
- Run tests with
bundle exec rake test. - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create new Pull Request