3.0.1 • Published 6 years ago
gulp-hash-references v3.0.1
gulp-hash-references
Replaces references (paths) to files according to the specified mapping file. Designed to be used with gulp-hash.
NOTE TO USERS UPGRADING FROM 1.x
The API of the plugin has changed significantly. Files where the references are to be updated should now be piped to the plugin, with the first argument being the path to the manifest file. See updated usage examples and API below.
Usage
var hash = require('gulp-hash');
var references = require('gulp-hash-references');
gulp.task('styles', function() {
return gulp.src('styles/**/*.css')
.pipe(hash()) // Generate hashes for the CSS files
.pipe(gulp.dest('dist')) // Save the renamed CSS files (e.g. style.123456.css)
.pipe(hash.manifest('asset-manifest.json')) // Generate a manifest file
.pipe(gulp.dest('.')); // Save the manifest file
});
gulp.task('update-references', function() {
return gulp.src('index.html')
.pipe(references('asset-manifest.json')) // Replace file paths in index.html according to the manifest
.pipe(gulp.dest('.'));
});
Streaming
This plugin does not support streaming. Please convert streaming vinyl files to buffers first using something like vinyl-buffer.
API
references(manifestPath, options)
manifestPath
Type: String
or String[]
Path to the manifest file, or an array of paths if using multiple manifest files.
options
Type: Object
options.dereference
Type: boolean
Default: false
If set to true, the plugin's functionality is reversed and the replaced file paths are reverted to the original path instead.