gulp-css-urlversion

Plugin inlines md5-based version of url() resources in css files to force web browsers to fetch updated resources only.

Install

$ npm install --save-dev gulp-css-urlversion

Usage

Example css/sass source:

.royal_button {
    background: url(/images/bg-royal-button.png) 0 0 no-repeat;
    width: 14px;
    height: 14px;
    cursor: pointer;
}

output css:

.royal_button {
    background: url(/images/bg-royal-button.png?v=aa73ac3b951818635c87dc4f56e9cc97) 0 0 no-repeat;
    width: 14px;
    height: 14px;
    cursor: pointer;
}

gulpfile.js:

var gulp = require('gulp'),
    sass = require('gulp-sass'),
    sourcemaps = require('gulp-sourcemaps'),
    cssUrlVersion = require('gulp-css-urlversion');

gulp.task('sass', function () {
    gulp.src('./sass/*.scss')
        .pipe(sourcemaps.init())
        .pipe(sass({errLogToConsole: true}))
        .pipe(cssUrlVersion({baseDir: './static/www/'}))
        .pipe(sourcemaps.write('../maps/newthemes/'))
        .pipe(gulp.dest(_csspath + 'css/'));
});

Options

baseDir - root for root-relative url() resources that you want to version. By default - process.cwd() is used as a root for root-relative resources.

ignoreFonts - ignore links that point to webfont files since 2.0.0

ignoreSvg - ignore links that point to .svg files since 2.0.0

Changelog

Version 2.0.0

support for Node 6.x and up
option for ignoring .svg files and fonts(.eot, .woff, .ttf, .otf)

Version 1.1.3

ignore https:// urls also

Version 1.1.2

handling closing paranthesis in url()s path to fix #1. Thanks @flftfqwxf :)
tests updated

Version 1.1.1

tests added

Version 1.1.0

Support for relative defined url()s
Support for multiple background declarations

gothy/gulp-css-urlversion

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages