HTML-Minifier Plugin for DocPad

Allows minification of HTML in DocPad, using HTML-Minifier.

Convention: .html.anything

Install

docpad install htmlmin

Usage

Create an HTML file with the htmlmin option:

---
htmlmin: true
---
<h1>HTML-Minifier Demo</h1>
<p>This file will be minified.</p>

<!-- This HTML comment will be removed when minified. -->

Configure

Defaults

The default configuration for this plugin is the equivalent of adding the following html-minifier options to your DocPad configuration file:

  plugins:
    htmlmin:
      removeComments: true
      removeCommentsFromCDATA: false
      removeCDATASectionsFromCDATA: false
      collapseWhitespace: true
      collapseBooleanAttributes: false
      removeAttributeQuotes: false
      removeRedundantAttributes: false
      useShortDoctype: false
      removeEmptyAttributes: false
      removeOptionalTags: false
      removeEmptyElements: false

      # Disabled on development environments.
      environments:
        development:
          enabled: false

Template Configuration

It is possible to override the default configuration on a per-template basis:

---
title: 'HTML-Minifier Demo'
htmlmin:
  removeComments: false
---
<h1>HTML-Minifier Demo</h1>
<p>This file will be minified.</p>

<!-- This HTML comment will not removed when minified. -->