## Usage

This helper should be used with an `app` created with [templates][] or something that inherits from [templates][]. See [related projects](#related-projects) for some apps that use [templates][]

### With [assemble][] and [engine-handlebars][]

Setup the helper by registering it with the app:

```js
// assemble is a descendant of `templates`
var app = assemble();
app.engine('hbs', require('engine-handlebars'));

// engines like handlebars can handle a helper name with dashes
app.helper('link-to', require('{%= name %}'));
```
Use the helper in a handlebars template:

```hbs
<a href="{{link-to 'about'}}">About</a>
```

Creates output like:

```html
<a href="./about.html">About</a>
```

### With [verb][] and [engine-base][]

Setup the helper by registering it with the app:

```js
// verb is a descendant of `templates`
var app = verb();
app.engine('md', require('engine-base'));

// engines like `engine-base` cannot handle a helper name with dashes
app.helper('linkTo', require('{%= name %}'));
```
Use the helper in a template:

```md
 - [Getting Started][{%%= linkTo("getting-started", "docs") %}]
```
Creates output like:

```md
 - [Getting Started][docs/getting-started.md]
```

## API
{%= apidocs('index.js') %}