Template helper for generating a markdown-formatted changelog from an object, array or yaml file.

This is a template helper that takes a changelog object, array, or filepath to a changelog file, and converts it to a markdown formatted changelog that looks something like this:

### [v0.2.0] - 2016-12-26
**fixed**
- Fixed [bug 10,997]
### [v0.1.0] - 2016-12-25
**deprecated**
- Deprecated `.foo` and `.bar`
**changed**
- Changed behavior of `.baz`

See stringify-changelog for details.

var changelog = require('helper-changelog');

<%= changelog(value, locals) %>

• value {String|Object|Array}: If the value is a string it will be regarded as a filepath. Supported file formats are yaml, json, and markdown.
• locals: Locals or options to pass to stringify-changelog. If a markdown file is passed, and it follows [keep-a-changelog][] conventions, the helper will attempt to generate reflinks to match the headings.

Note: When a filepath is passed, the file name can be anything, but the extension is used for determining how to parse the file:

// file path to a valid yaml file
<%= changelog("CHANGELOG") %>
<%= changelog("CHANGELOG.yml") %>
<%= changelog("CHANGELOG.yaml") %>
// file path to a valid JSON file
<%= changelog("CHANGELOG.json") %>
// changelog object passed as a variable on the context
<%= changelog(changes) %>
// changelog object passed as locals
<%= changelog({ 
  "v0.1.0": { 
    date: "2016-12-26", 
    changes: [ "Got stuck in another chimney." ] 
  }
}) %>
// changelog array passed as locals
<%= changelog([
  {
    date: "2016-12-26", 
    version: "v0.1.0", 
    changes: [ "Got stuck in another chimney." ]
  }
]) %>

YAML

The contents of the file must be valid YAML following this format:

v0.1.0:
  date: "2016-12-26"
  changes:
    - Got stuck in another chimney.

See stringify-changelog for additional options.

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Install dev dependencies:

$ npm install -d && npm test

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

This file was generated by verb, v0.9.0, on July 21, 2016.