Cachebusting all local files in css
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.githooks/pre-commit
test
.DS_Store
.eslintrc.json
.gitignore
.jshintrc
.npmignore
.travis.yml
CHANGELOG.md
LICENSE
README.md
gulpfile.js
index.js
package.json

README.md

PostCSS Cachebuster Build Status npm version

[PostCSS] plugin added cachebuster to local files based on their datechanged.

Input css example

@import url("/css/styles.css");
.foo {
  background-image : url('../images/index/logo.png');
  behavior : url('../behaviors/backgroundsize.min.htc');
}
@font-face {
  font-family: 'My font';
  src: url('fonts/myfont.ttf');
}

Output css example

@import url("/css/styles.css?v66f22a33fff");
.foo {
  background-image : url('../images/index/logo.png?v14f32a475b8')
  behavior : url('../behaviors/backgroundsize.min.htc?v15f55a666c2');
}
@font-face {
  font-family: 'My font';
  src: url('fonts/myfont.ttf?v32f14a88dcf');
}

Configure

postcss([ 
  require('postcss-cachebuster')({
    imagesPath : '/images', 
    cssPath : '/stylesheets'
  }) 
])

See [PostCSS] docs for examples for your environment.

Options

  • cssPath - option to redefine relative images resolving directory (by default the same as css file folder)
  • imagesPath - variable to define absolute images base path
  • type - define cachebuster type, mtime by default, allows: mtime, checksum (checksum based on md5), or a function which receives the absolute path to the file as an argument and whose return value becomes the url pathname.

Contributors