Skip to content

A zero-dependency HTML/CSS/Javascript minifier for the Crystal language

License

Notifications You must be signed in to change notification settings

sam0x17/html-minifier

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

html-minifier

html-minifier embeds the widely-used html-minifier NPM package in an easy-to-use Crystal shard via duktape.cr, which provides a fast, embedded Javascript execution environment within Crystal.

html-minifier can be used to minify arbitrary HTML content, including Javascript and/or CSS.

Some features:

  • minifies HTML and any embedded CSS/Javascript within the HTML
  • no non-Crystal dependencies (no Node.js or NPM required)
  • all html-minifier Javascript is baked into the shard, so you won't need to package any extra files with your app/tool/library
  • doesn't embed an entire Node.js runtime (Javascript is executed via duktape.cr)
  • simple, Crystal-based API (HtmlMinifier.minify!("source code")
  • full support for html-minifier options via HtmlMinifier.set_options
  • sane, one-size-fits-all options are included by default (unlike html-minifier on NPM)

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      html-minifier:
        github: sam0x17/html-minifier
  2. Run shards install

Minification

require "html-minifier"

HtmlMinifier.minify!("<html>  <body>minify  me!</body></html>") # => "<html> <body>minify me!</body></html>"
HtmlMinifier.minify!("<style>body { background-color: black }</style>") # => "<style>body{background-color:#000}</style>"
HtmlMinifier.minify!("<script> alert('hello world');</script>") # => "<script>alert(\"hello world\")</script>"

Configuration

All options supported by html-minifier on NPM are supported by this shard. Options can be specified by a JSON::Any object or by a JSON string, as shown below.

require "html-minifier"

HtmlMinifier.minify!("<html><!-- comment --></html>") # => "<html></html>"

HtmlMinifier.set_options("{\"removeComments\": false}")

HtmlMinifier.minify!("<html><!-- comment --></html>") # => "<html><!-- comment --></html>"

Note that user-specified options will override their respective default values. The default values for all options are shown below:

{
  "caseSensitive": true,
  "conservativeCollapse": true,
  "minifyCSS": true,
  "minifyJS": true,
  "useShortDoctype": true,
  "removeTagWhitespace": true,
  "removeScriptTypeAttributes": true,
  "removeComments": true,
  "collapseWhitespace": true,
  "collapseInlineTagWhitespace": true,
}

About

A zero-dependency HTML/CSS/Javascript minifier for the Crystal language

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published