A fork of metalsmith-fingerprint that discards the original file
JavaScript
Latest commit 1bce01a Oct 31, 2015 @ismay ismay 1.1.2
Permalink
Failed to load latest commit information.
lib
test
.gitignore Add plugin files Aug 31, 2015
.travis.yml
History.md
LICENSE.md
README.md
package.json 1.1.2 Oct 31, 2015

README.md

metalsmith-fingerprint-ignore

npm Build Status Dependency Status devDependency Status npm

A fork of metalsmith-fingerprint that discards the original file

This plugin fingerprints your files for easy and reliable cache-busting. Since you're not going to use the original, this fork discards it by default (but still allows you to keep it if you want to).

Installation

npm install metalsmith-fingerprint-ignore

Example

Say you want to fingerprint the file css/index.css:

Metalsmith(__dirname)
  .use(fingerprint({ pattern: 'css/index.css' }))
  .use(template({ engine: 'handlebars' }))
  .build()

The plugin does three things:

  1. create a duplicate of index.css with a fingerprinted filename
  2. create a fingerprint object on the Metalsmith metadata
  3. Discard the original index.css file

The fingerprint object is accessible from the Handlebars template:

<link href="{{ fingerprint.[css/index.css] }}" rel="stylesheet" type="text/css" />

And the template renders the fingerprinted filename:

<link href="css/index-724af9dd72a48c18dd570790c2445fb4.css" rel="stylesheet" type="text/css" />

Options

You can pass options to metalsmith-fingerprint-ignore with the Javascript API or CLI. The options are:

  • pattern: a pattern to filter source files (required)
  • keep: keep source file, false by default (optional)

pattern

String|Array<String>: A pattern to filter source files. The path is relative to your source. Required.

{
  "plugins": {
    "metalsmith-fingerprint-ignore": {
      "pattern": "css/index.css"
    }
  }
}

keep

Boolean: Keep the original file. Setting it to true will keep the original file and create a fingerprinted version as well. Default false. Optional.

{
  "plugins": {
    "metalsmith-fingerprint-ignore": {
      "pattern": "css/index.css",
      "keep": "true"
    }
  }
}

Origins

Metalsmith fingerprint does not discard the original file after fingerprinting. So when fingerprinting a large collection of files you'll have to manually ignore them all. Unfortunately the only predictable difference between the original and the fingerprinted file is the dash before the fingerprint.

An issue was opened to address this, but closed as wontfix. So this fork is based on the PR by callum, which can be used by those who would still like this functionality.

Thanks to:

License

MIT.