A Metalsmith plug-in to minify HTML files using kangax/html-minifier.
Be aware that certain optimizations are enabled by default in this plug-in, some of which may not be what you want. Please read the documentation to ensure you understand what is happening to your markup and disable options as required.
The usual:
$ yarn add metalsmith-html-minifier
A quick example:
const Metalsmith = require("metalsmith");
const htmlMinifier = require("metalsmith-html-minifier");
Metalsmith(__dirname)
.use(htmlMinifier()) // Use the default options
.build();The above will minify all the HTML files (files ending in .html) it processes. To provide a custom glob for files to minify:
const Metalsmith = require("metalsmith");
const htmlMinifier = require("metalsmith-html-minifier");
Metalsmith(__dirname)
.use(htmlMinifier({
pattern: "**/*.html",
}))
.build();You can also pass an array of globs to match filenames:
const Metalsmith = require("metalsmith");
const htmlMinifier = require("metalsmith-html-minifier");
Metalsmith(__dirname)
.use(htmlMinifier({
pattern: ["**/*.html", "**/*.xhtml"],
}))
.build();To pass options to the minifier (to enable or disable optimizations):
const Metalsmith = require("metalsmith");
const htmlMinifier = require("metalsmith-html-minifier");
Metalsmith(__dirname)
.use(htmlMinifier({
minifierOptions: {
removeComments: false,
// etc.
},
}))
.build();See Options Quick Reference for a full reference. The options passed to the plug-in are merged with the defaults below and passed to the minifier directly.
The following options are enabled by default. To disable any of these you will need to explicitly set them to false.
| Option | Description |
|---|---|
collapseBooleanAttributes |
Omit attribute values from boolean attributes |
collapseWhitespace |
Collapse white space that contributes to text nodes in a document tree |
removeAttributeQuotes |
Remove quotes around attributes when possible |
removeComments |
Strip HTML comments |
removeEmptyAttributes |
Remove all attributes with whitespace-only values |
removeRedundantAttributes |
Remove attributes when value matches default |
To run the tests:
$ npm test
This software is released under the MIT License. See LICENSE.md for more information.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
![greenkeeper[bot] avatar](https://avatars.githubusercontent.com/in/505?v=4 "greenkeeper[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent