# {{{%= name %}}} {%= badge('fury') %}

> {%= description %}

**Heads up!** v0.3.0 of this helper requires Assemble v0.5.0 and greater!


## Install

Use [npm](npmjs.org) to install the package: `npm i handlebars-helper-slugify`.

To automatically load helpers from node_modules, see [resolve-dep](https://github.com/jonschlinkert/resolve-dep).

## Register the helper

In your project's Gruntfile, to register the helper add `handlebars-helper-slugify` to the `helpers` property in the [Assemble](http://assemble.io) task or target options:

```javascript
grunt.initConfig({
  assemble: {
    options: {
      // the 'handlebars-helper-slugify' npm module must also be listed in
      // devDependencies for assemble to automatically resolve the helper
      helpers: ['handlebars-helper-slugify', 'foo/*.js']
    },
    files: {
      '_gh_pages/': ['templates/pages/*.hbs']
    }
  }
});
```

Now that the helper is registered, you may begin using it in your templates.

## Usage

Given file name: `Executive Summary 2013.md`:

```html
{{slugify page.filename}}
```

Renders to `executive-summary-2013.md`.

## Credit
This helper is based on the `slugify` method from [underscore.string](http://epeli.github.com/underscore.string/), thank you to the maintainers and contributors of that library!

## Author
{%= contrib("jon") %}

## License
{%= copyright() %}
{%= license() %}

***

{%= include("footer") %}