Skip to content
Emblem.js - Ember-friendly, indented syntax alternative for Handlebars.js
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Wrap in ember-cli for better test harness Dec 18, 2018
lib
tests
.gitignore
.jshintrc Initial Ember-CLI WIP Feb 18, 2015
.npmignore
.travis.yml Wrap in ember-cli for better test harness Dec 18, 2018
CHANGELOG.md 0.12.1 Jan 4, 2019
LICENSE executable can now read from STDIN Jan 25, 2013
README.md Cleanup README Dec 22, 2018
VANILLA_HANDLEBARS.md Add Changelog Mar 2, 2015
ember-cli-build.js
emblem-source.gemspec added MIT license to gemspec. Closes #86 Aug 21, 2013
package.json Move some dev dependencies out of dependencies Jan 4, 2019
testem.js Wrap in ember-cli for better test harness Dec 18, 2018
yarn-error.log Wrap in ember-cli for better test harness Dec 18, 2018
yarn.lock Wrap in ember-cli for better test harness Dec 18, 2018

README.md

Build Status

Emblem.js

Emblem.js is an indentation-based templating language that prints Handlebars.js templates. Specifically, it targets Ember.js templates.

Emblem's syntax most closely resembles that of the Slim templating language. Please see the Emblem docs site for a full explanation of the syntax.

Also check out the Embercast on Emblem.js

Installation with Ember-CLI

To use Emblem with Ember-CLI, use the ember-cli-emblem addon.

Handlebars Version Dependencies

As of Emblem 0.5.0, the compiler is really a template printer. Previous versions compiled to Handlebars AST nodes and were forced to target specific versions of Handlebars. The move to printing has eliminated that restriction, and Emblem 0.5.0 should be compatible with any version of Handlebars.

For posterity, here is a history of Emblem and Handelbars compatibility across revisions.

  • HTMLBars: Emblem 0.5.0+
  • Handlebars 2.0.0: Use Emblem ~0.4.0, or 0.5.0+
  • Handlebars 1.0.0: Use Emblem ~0.3.0, or 0.5.0+
  • Handlebars <= 1.0.0.rc4: Use Emblem <= 0.2.9, or 0.5.0+

Using Emblem in your application

Previous versions of Emblem have supported a "vanilla" Handlebars mode. The intent was that Ember-specific helpers could be avoided.

Emblem 0.5.0 dropped support for vanilla template compilation, but we would like to bring it back. Please refer to VANILLA_HANDLEBARS.md for more context.

Building Emblem.js

Clone the repo, then run:

yarn install
ember build

To run tests in the browser, run:

ember test --serve

The tests will be available at http://localhost:4200/tests/.

To run tests in Headless Chrome and Node (which is how CI runs), use:

ember test

Reporting Bugs

If you find a bug in Emblem syntax, please try to reproduce it in its simplest form with this JSBin before reporting an issue, which will help me nail down the source of the issue.

Bitdeli Badge

Emblem was authored and released by Alex Matchneer (@machty).

The Emblem 0.5.0 release was generously funded by Vestorly. Vestorly is a technology company solving the content marketing problem for individual professionals, small businesses, and the enterprises that support them. Vestorly's user interface is built entirely with Ember.js and modern web technologies. Vestorly is hiring!

You can’t perform that action at this time.