gulp-vhash

gulp-vhash

Asset versioning (for browser caching optimization)

1. Static HTML File(s)

Creating or updating content hash value as parameter to src/href attributes in HTML or template files without manual preparations (like html comments).

Stylesheet

<link rel="stylesheet" href="common.css"/>

Result:

<link rel="stylesheet" href="common.css?v=185d182710c120e9051d20fa386a4212/>

JavaScript

<script src="all.min.js"></script>

Result:

<script src="all.min.js?v=e86bfc2fd4d6c2f86825791492d88283"></script>

2. JSON Hash File

Saves a file named 'vhash.json' in root directory with matched file names (as identifiers) and the md5 hash values.

{
  "common.css": "185d182710c120e9051d20fa386a42",
  "all.min.js": "e86bfc2fd4d6c2f86825791492d88283"
}

Note

Please read 'Add an Expires or a Cache-Control Header!'

Install

$ npm install gulp-vhash

Usage

var gulp = require('gulp');
var vhash = require('gulp-vhash');

gulp.task('default', function() {
  
  return gulp.src(
    'src/**/*.{js,css}'
  )
  .pipe(vhash(
    'html/**/*.{htm*,tmpl}'
   ));
  
});

License

MIT © Uli Preuss