handlebars-helper-slugify
v0.3.2
Published
{{slugify}} handlebars helper. Uses the awesome underscore.string to transform text into a URL slug. Replaces whitespaces, accentuated and special characters with a dash.
Downloads
348
Maintainers
Readme
{{handlebars-helper-slugify}}
{{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.