Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Convert strings into URL slugs.
JavaScript
Branch: master

README.md

{{handlebars-helper-slugify}} NPM version

{{slugify}} handlebars helper. Uses the awesome underscore.string to transform text into a URL slug. Replaces whitespaces, accentuated and special characters with a dash.

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

Install

Use npm to install the package: npm i handlebars-helper-slugify.

To automatically load helpers from node_modules, see 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 task or target options:

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:

{{slugify page.filename}}

Renders to executive-summary-2013.md.

Credit

This helper is based on the slugify method from underscore.string, thank you to the maintainers and contributors of that library!

Author

Jon Schlinkert

License

Copyright (c) 2014 Jon Schlinkert, contributors.
Released under the MIT license


This file was generated by verb-cli on May 10, 2014.

Something went wrong with that request. Please try again.