Skip to content

jbest84/NUglify

Repository files navigation

NUglify CI NuGet

NUglify provides minify and compression methods for CSS, JavaScript and HTML files.

This repository is a fork of the Microsoft Ajax Minifier + additional features (e.g: HTML compressor)

While dotnet Core is now relying on the node.js ecosystem for its client side tooling (e.g: minify), NUglify is still useful in scenarios where we need to access this tooling from a .NET application (not necessarily an ASP one) without having to install another developer platform.

The original AjaxMin documentation of the project is available here

See the ChangeLog

Features

  • JS minification
    • Fully ES2020 + ES2021 compliant
  • Css minification
  • HTML minification
    • Can help to reduce by 5-10% a standard HTML document
    • Supports several minifications methods: remove comments, collapse whitespaces, remove optional tags (p, li...), remove quoted attributes, remove specific attributes, decode HTML entities, compress inline style and script using NUglify
    • No regex involved, full HTML parser
    • Supports HTML5, works best on valid HTML documents (but can still work on invalid documents)
    • Similar to the popular html-minifier in JS
    • Super fast and GC friendly parser and minifier, 10x times faster than existing html compressor for .NET
    • Method Uglify.HtmlToText that allows to extract the text from an HTML document
  • Compatible with .NET Framework 4.0, .NET Standard 2.0, and .NET 10.0

Download

NUglify is available as a NuGet package: NuGet

Usage

Basic usage

The main entry point for the API is the Uglify class:

For JavaScript:

var result = Uglify.Js("var x = 5; var y = 6;");
Console.WriteLine(result.Code);   // prints: var x=5,y=6

For Css:

var result = Uglify.Css("div { color: #FFF; }");
Console.WriteLine(result.Code);   // prints: div{color:#fff}

For Html:

var result = Uglify.Html("<div>  <p>This is <em>   a text    </em></p>   </div>");
Console.WriteLine(result.Code);   // prints: <div><p>This is <em>a text</em></div>

Extract text from Html:

var result = Uglify.HtmlToText("<div>  <p>This is <em>   a text    </em></p>   </div>");
Console.WriteLine(result.Code);   // prints: This is a text

HTML

See the xmldoc comments on the properties of NUglify.Html.HtmlSettings for all your HTML minification needs.

For example, to output indented (with tabs) HTML:

var htmlSettings = HtmlSettings.Pretty();
htmlSettings.Indent = "\t";
var output = Uglify.Html(input, htmlSettings);

JS

TODO

CSS

TODO

Known Issues

None

Questions

  • Can we collaborate with a project like Jint to leverage on a common JavaScript parser infrastructure?
  • Can we utilise AngleSharp for the HTML/Css minification?

License

This package includes the repository license.txt file, which covers the BSD 2-Clause terms for NUglify and the original Apache 2.0 notice for Microsoft Ajax Minifier.

Author

Microsoft Ajax Minifier was created and maintained by Ron Logan, with contributions from Eugene Chigirinskiy, Rafael Correa, Kristoffer Henriksson, and Marcin Dobosz.

Nuglify was ported and refactored to github by Alexandre Mutel aka xoofx

It is now maintained by Jason Best aka jbest84

Previous Maintainers

Andrew Bullock aka trullock

Credits

The logo Monster is by Joel McKinney from the Noun Project

About

NUglify is a HTML, JavaScript and CSS minification Library for .NET (fork of AjaxMin + new features)

Resources

License

Code of conduct

Contributing

Stars

434 stars

Watchers

19 watching

Forks

Packages

 
 
 

Contributors