helpers /  Readme



Generates a list of markdown-formatted project authors from the AUTHORS file in the root of a project. Since Handlebars enforces case sensitivity with helper names, this helper comes in two different flavors: {{AUTHORS}} or {{authors}}.

Params: none Usage: {{authors}} or {{authors "path/to/AUTHORS"}}

For data, we'll use the AUTHORS file in the root of our project. We format it this way so that NPM can:

Brian Woodward (
Jon Schlinkert (

Template (lowercase version):


Renders to:

* [Brian Woodward](
* [Jon Schlinkert](

Renders to:

**Jon Schlinkert** 
+  [] ( )
+  [] ( )
**Brian Woodward** 
+  [] ( )
+  [] ( )


A few convenience helpers that read data in YAML format, and do interesting things with the data. Well... they "do things" with the data. Anyway I guess only nerds like me find it interesting.

NOTE: These helpers will throw an error if the source files are not valid YAML format, using the following conventions:

A couple things to keep in mind about YAML:

  • YAML is picky, so don't be surprised if the parser throws an error from improperly placed quotation marks.
  • Seriously, don't be surprised. If you even come onto the issues and act surprised when it happens, an automated message will tell you to read the first bullet.

Example of the format to follow in your CHANGELOG file:

  date: "2014-04-09"
    - The future sucks.
    - This is my third and last commmit from the future.
  date: "2014-04-08"
    - Second commit from the future.
    - The future is more boring that I thought it would be.
  date: "2014-03-07"
    - First commit... from the future. Yes!

Of coure, you are under no obligation to make your changelog entries as interesting as these, and you may record your entries at any point in whatever timeline you prefer, but whatever you write must be valid YAML when you do it.

The output will look like this:

*  2013-03-15    v0.1.2    Update with documentation, examples.
*  2013-03-06    v0.1.0    First commit.

Travis CI


Creates a "full" Travis CI link in markdown format.

Params: branch Type: String Usage: {{travis [branch]}}



Renders to:

# [assemble v9.1.0]([![Build Status](]( 

Template with branch:

{{travis 'master'}}

Renders to:

# [assemble v9.1.0]([![Build Status](]( 


Creates a Travis CI link in markdown format.

Params: none Usage: {{travis-badge}}



Renders to:

[![Build Status](] ( )

See the template for this page →

Find an error? Let us know →