metalsmith-html-minifier

    4.0.1 • Public • Published

    Metalsmith HTML Minifier

    npm

    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.

    Installation

    The usual:

    $ npm install --save metalsmith-html-minifier
    

    How do I use this thing?

    A quick example:

    var Metalsmith   = require("metalsmith");
    var 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:

    var Metalsmith   = require("metalsmith");
    var htmlMinifier = require("metalsmith-html-minifier");
    Metalsmith(__dirname)
        .use(htmlMinifier({
            pattern: "**/*.html",
        }))
        .build();

    You can also pass an array of globs to match filenames:

    var Metalsmith   = require("metalsmith");
    var htmlMinifier = require("metalsmith-html-minifier");
    Metalsmith(__dirname)
        .use(htmlMinifier({
            pattern: ["**/*.html", "**/*.xhtml"],
        }))
        .build();

    To pass options to the minifier (to enable or disable optimizations):

    var Metalsmith   = require("metalsmith");
    var htmlMinifier = require("metalsmith-html-minifier");
    Metalsmith(__dirname)
        .use(htmlMinifier({
            minifierOptions: {
                removeComments: false,
                // etc.
            },
        }))
        .build();

    Options

    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

    Tests

    To run the tests:

    $ npm test
    

    License

    This software is released under the MIT License. See LICENSE.md for more information.

    Keywords

    none

    Install

    npm i metalsmith-html-minifier

    DownloadsWeekly Downloads

    158

    Version

    4.0.1

    License

    MIT

    Unpacked Size

    8.48 kB

    Total Files

    8

    Last publish

    Collaborators

    • whymarrh