Skip to content
This repository has been archived by the owner. It is now read-only.
master
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

SharedMustache

Add the ability to share mustache templates in Rails and JavaScript.

Mustache templates will be rendered using Ruby mustache on the server.

On the client there is a jQuery helper to let you use the template. In development the templates are outputted on the page in script blocks. For production the templates are compiled using hogan.js, the compiled templates can then be included into your standard JavaScript file using the asset-pipeline.

Installation

Add 'shared_mustache' to your your application's Gemfile.

By default when you run rake shared_mustache:compile it will put the outputed templates JavaScript at Rails.root/app/assets/javascript/templates.js. This can be configured using an intializer. The templates.js file should be kept empty for development and only populated in production.

You should add the following lines to your application.js:

//= require shared_mustache
//= require templates

This adds the jQuery helper for you to use the templates and in production will add the compiled templates.

At the bottom of your main layout you should add:

<%= render_mustache_templates if Rails.env.development? %>

Add rake shared_mustache:compile before the assets:precompile step of your deploy script.

Currently it expects your views to be found under app/views.

Usage

Create mustache templates as you would erb partials. So for example at app/views/home/_row.mustache. You can then render it in an erb template using:

<%= render_mustache('home/row', context) %>

It tries to use the same conventions as the native render methods. Such that you can ommit the controller if the mustache is in the same folder as the currently executing controller.

In your JavaScript you should get access to jQuery methods to interact with the mustache templates:

$.mustache('home/_row', context);

About

Share mustache between Rails templates and the browser (using compiled hogan.js templates).

Topics

Resources

License

Packages

No packages published

Languages