# Ember::Middleman

[![Build Status](https://travis-ci.org/tricknotes/ember-middleman.png?branch=master)](https://travis-ci.org/tricknotes/ember-middleman)
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/tricknotes/ember-middleman/trend.png)](https://bitdeli.com/free "Bitdeli Badge")

ember-middleman supports using Ember.js with Middleman in easily.
You can use this with [hamlbars](https://github.com/jamesotron/hamlbars) if you like.

_This gem is inspired by [ember-rails](http://github.com/emberjs/ember-rails)._

## Installation

Add this line to your application's Gemfile:

``` ruby
gem 'ember-middleman'
gem 'ember-source' # You can specify the version you want to use
```

Execute:

``` sh
$ bundle
```

Or install it yourself as:

``` sh
$ gem install ember-middleman
```

And insert the following line to your `config.rb`:

``` ruby
activate :ember
```

## Features

When you installed ember-middleman, the following features help you.

### Path to libraries

You can use Ember.js and ember-data.
Please write the followings to your `application.js` (or something you use):

_You should require jQuery before require ember_.

``` javascript
//= require ember
//= require ember-data
```

### HTMLBars precompilation

You can use HTMLBars as your template language for Ember.js.

``` sh
$ mkdir -p source/javascripts/templates
```

And put your template.

For example:

* `source/javascripts/templates/ok-button.js.hbs`

``` hbs
<div>
  <button {{action "someAction"}}>OK</button>
</div>
```

It automatically set as `Ember.TEMPLATES['ok-button']`.

**Without precompilation, `ember-template-compiler.js` is required for client side compilation.**

### Generator

You can generate a fresh project already setup for ember:

``` ruby
# Gemfile

source 'https://rubygems.org'

gem 'middleman'
gem 'ember-middleman'
```

``` sh
$ bundle exec middleman init . --template=ember
```

## Tests

``` sh
bundle exec rake
```

### Use Handlebars (using Ember.js < 1.10)

When you use Ember.js < 1.10, `handlebars` is required in your `application.js`.

``` js
//= require handlebars
```

## Example Repository

* [sapporojs.org](https://github.com/sapporojs/sapporojs.org)