Works with gulp-rev-client
- gulp-rev-client
- gulp-rev-collector-client - Static asset revision data collector
This project is feature complete.
Make sure to set the files to never expire for this to have an effect.
🔥 Want to strengthen your core JavaScript skills and master ES6?
I would personally recommend this awesome ES6 course by Wes Bos.
Install
$ npm install --save-dev gulp-rev-client
Usage
const gulp = ;const rev = ; gulp;
API
rev()
rev.manifest([path], [options])
path
Type: string
Default: rev-manifest.json
Manifest file path.
options
base
Type: string
Default: process.cwd()
Override the base
of the manifest file.
cwd
Type: string
Default: process.cwd()
Override the current working directory of the manifest file.
merge
Type: boolean
Default: false
Merge existing manifest file.
transformer
Type: object
Default: JSON
An object with parse
and stringify
methods. This can be used to provide a
custom transformer instead of the default JSON
for the manifest file.
Original path
Original file paths are stored at file.revOrigPath
. This could come in handy for things like rewriting references to the assets.
Asset hash
The hash of each rev'd file is stored at file.revHash
. You can use this for customizing the file renaming, or for building different manifest formats.
Asset manifest
const gulp = ;const rev = ; gulp;
An asset manifest, mapping the original paths to the revisioned paths, will be written to build/assets/rev-manifest.json
:
By default, rev-manifest.json
will be replaced as a whole. To merge with an existing manifest, pass merge: true
and the output destination (as base
) to rev.manifest()
:
const gulp = ;const rev = ; gulp;
You can optionally call rev.manifest('manifest.json')
to give it a different path or filename.
gulp-concat
Sourcemaps and Because of the way gulp-concat
handles file paths, you may need to set cwd
and path
manually on your gulp-concat
instance to get everything to work correctly:
const gulp = ;const rev = ;const sourcemaps = ;const concat = ; gulp
Different hash for unchanged files
Since the order of streams are not guaranteed, some plugins such as gulp-concat
can cause the final file's content and hash to change. To avoid generating a new hash for unchanged source files, you can:
- Sort the streams with gulp-sort
- Filter unchanged files with gulp-unchanged
- Read more about incremental builds
Streaming
This plugin does not support streaming. If you have files from a streaming source, such as Browserify, you should use gulp-buffer
before gulp-rev
in your pipeline:
const gulp = ;const browserify = ;const source = ;const buffer = ;const rev = ; gulp;
Integration
For more info on how to integrate gulp-rev-client
into your app, have a look at the integration guide.
- 本插件為個人部分調整代碼適應項目使用,使用前請確認是否適合自己所在項目
- 該插件依賴為 gulp-rev
- 做出以下調整
var rev = require('gulp-rev-client);
rev({
// 默認為false 壓縮後綴為 ./css/main.min.css?v=1e2c45287b
// 默認為true 壓縮後綴為 ./css/main.min.1e2c45287b.css
hash:true | false
})