https://github.com/wheelo/gulp-version-patch

a gulp plugin which patches the included files versions in html & css
https://github.com/wheelo/gulp-version-patch

gulp patch plugin version

Last synced: about 5 hours ago
JSON representation

a gulp plugin which patches the included files versions in html & css

• Host: GitHub
• URL: https://github.com/wheelo/gulp-version-patch
• Owner: wheelo
• License: mit
• Created: 2016-12-21T12:50:40.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-01-06T07:43:12.000Z (almost 8 years ago)
• Last Synced: 2024-10-12T20:41:15.402Z (about 1 month ago)
• Topics: gulp, patch, plugin, version
• Language: JavaScript
• Homepage: https://www.npmjs.com/package/gulp-version-patch
• Size: 54.7 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 46
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
## gulp-version-patch

A gulp plugin which patches the version of included resource files in html & css files

## Installation

```bash

npm install gulp-version-patch

```

## Usage

```js

var gulp = require('gulp');

var versionPatch = require('gulp-version-patch');

gulp.task('patchcss', function () {

    return gulp.src('./test/*.css')

     	// default: {versionType: '%MD5%', patchMode: 0}

        .pipe(versionPatch({versionType: '%DT%'}))

        .pipe(gulp.dest('./test/dist'))

});

// will not patch the image resource, for base64 replacement & etc..

gulp.task('patch', ['patchcss'], function () {

    gulp.src("./test/*.html")

        .pipe(versionPatch({patchMode: 1}))

        .pipe(gulp.dest('./test/dist'));

});

gulp.task('default', ['patch']);

```

#### Notice: the file generated will have the shape of `?v=abcd123` as suffix.

## Options

**Patch Modes**

When using this patch plugin you might specify the param `{ patchMode: MODE }` to indicate the patch mode. There are 4 patching modes avaibale right now. Either of 4 resources type could be version-patched: script, stylesheet and image resource reference(in html) and background url (in css/less). Hence the params of `MODE` can be chosen from `0, 1, 2, 3` as follows: 

- `0`: patch all above four patched types in both html and css

- `1`: not patch the image resource 

- `2`: only patch the script and css

- `3`: only patch the script

You can while yet omit this params. It turns out that, the package will then automatically use the dafault MODE of `0`.

**Version Types**

When the package comes to version 0.5.0, we have one exciting feature to specify the type of patched version. You might specify the param `{ versionType: TYPE }` to indicate the patched version type. Either the modes of date, time and MD5 can be specified. Moreover, you can specify your own DIY type for patching (i.e., the last one as below). The param `TYPE` can be chosen one of the following:

- `%DATE%`  date [**YYYYMMDD**]

- `%DT%`  date + time [**YYYYMMDDHHIISS**]

- `%TS%`  timestamp [**INT**10]

- `%TSM%`  timestamp(millisecond) [**INT**13]

- `%MD5%`  MD5(timestamp) [**STRING**32]

- `%MDS%`  MD5(MD5(timestamp) + salt) [**STRING**32]

- `{STRING}`  In addition to the above keywords, considered custom

When you omit the param `versionType`, the module will use the default type `%MD5%` to patch resources.