• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

Dragory/gulp-hash: A gulp plugin for cachebusting files by adding a hash to thei ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

Dragory/gulp-hash

开源软件地址(OpenSource Url):

https://github.com/Dragory/gulp-hash

开源编程语言(OpenSource Language):

JavaScript 100.0%

开源软件介绍(OpenSource Introduction):

gulp-hash NPM version Build Status

Cachebust your assets by adding a hash to the filename

npm install --save-dev gulp-hash

Basic usage

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

gulp.src('./js/**/*.js')
	.pipe(hash()) // Add hashes to the files' names
	.pipe(gulp.dest('public/js')) // Write the renamed files
	.pipe(hash.manifest('public/assets.json', { // Generate the manifest file
	  deleteOld: true,
	  sourceDir: __dirname + '/public/js'
	}))
	.pipe(gulp.dest('.')); // Write the manifest file (see note below)

The "manifest" is a JSON file that maps the original filenames to the renamed ones.

Note: It is recommended to use the full relative path to the manifest file in hash.manifest() as opposed to setting it in gulp.dest(). This is so the append option is able find the original manifest file. The example above demonstrates this.

Streaming

The plugin fully supports both buffers and streams. If you encounter any problems, please open an issue on GitHub and I'll look into it!

API

hash(options)

Option Default Description
algorithm 'sha1' A hashing algorithm for crypto.createHash
hashLength 8 The length of the hash to add to the file's name (slice from the start of the full hash)
template '<%= name %>-<%= hash %><%= ext %>' The template used when adding the hash
version '' A key to change the files' hashes without actually changing their content; appended to the contents when hashing

hash.manifest(manifestPath, options)

Parameter Default Description
manifestPath (none) The desired path to the manifest file
options.append true Whether to merge the new manifest with an existing one's contents (same filename, doesn't have to exist before first run)
options.space null The space parameter for JSON.stringify()
options.deleteOld false If set to true, deletes old versions of hashed files
options.sourceDir __dirname Used with deleteOld. Specifies where to search for old files to delete.

hash.manifest(manifestPath, append, space)

Parameter Default Description
manifestPath (none) The desired path to the manifest file
append true (optional) Whether to merge the new manifest with an existing one's contents (same filename, doesn't have to exist before first run)
space undefined (optional) The space parameter for JSON.stringify()



鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap