handlebars-helper-filehash
v1.0.0
Published
{{ fileHash }} Handlebars helper for generating an md5 hash from a file's content
Downloads
8
Readme
{{ fileHash }}
The {{ fileHash }} Handlebars helper generates an md5 hash from a specified file's content. Perfect for automatically cache-busting modified assets (e.g. stylesheets).
Quickstart
In the root of your project, run the following in the command line:
npm install handlebars-helper-filehash --save-dev
Assemble Usage
If you use Assemble and Grunt, add handlebars-helper-filehash
to the helpers
property in your Gruntfile's Assemble task or target options:
grunt.initConfig({
assemble: {
options: {
// the 'handlebars-helper-filehash' module must also be listed in
// devDependencies for assemble to automatically resolve the helper
helpers: ['handlebars-helper-filehash', 'foo/*.js']
}
...
}
});
You can now use begin using the helper in your templates. To use the helper, pass a file path and optionally include a number as a second parameter if you wish to limit the output to a set length.
Template:
<link rel="stylesheet" href="/assets/css/main.css?{{ fileHash './public/assets/css/main.css' 10 }}">
Output:
<link rel="stylesheet" href="/assets/css/main.css?e5b5b3e0fc">
License and Copyright
Copyright (c) 2014 Andrew Duthie
Released freely under the MIT License (refer to LICENSE.txt)