NAME
HTML::Packer - Another HTML code cleaner
VERSION
Version 2.11
DESCRIPTION
A HTML Compressor.
SYNOPSIS
use HTML::Packer;
my $packer = HTML::Packer->init();
$packer->minify( $scalarref, $opts );
To return a scalar without changing the input simply use (e.g. example 2):
my $ret = $packer->minify( $scalarref, $opts );
For backward compatibility it is still possible to call 'minify' as a function:
HTML::Packer::minify( $scalarref, $opts );
First argument must be a scalarref of HTML-Code. Second argument must be a hashref of options. Possible options are
- remove_comments
-
HTML-Comments will be removed if 'remove_comments' has a true value. Comments starting with
<!--#
,<!--[
or<!-- google_ad_section_
will be preserved unless 'remove_comments_aggressive' has a true value. - remove_comments_aggressive
-
See 'remove_comments'.
- remove_newlines
-
ALL newlines will be removed if 'remove_newlines' has a true value.
- do_javascript
-
Defines compression level for javascript. Possible values are 'clean', 'obfuscate', 'shrink' and 'best'. Default is no compression for javascript. This option only takes effect if JavaScript::Packer is installed.
- do_stylesheet
-
Defines compression level for CSS. Possible values are 'minify' and 'pretty'. Default is no compression for CSS. This option only takes effect if CSS::Packer is installed.
- do_csp
-
Defines hash algorithm for
Content-Security-Policy
, or CSP, hashes of embedded<script>
and<style>
tags.Allowed values are
'sha256'
,'sha384'
,'sha512'
.It may be left blank or set to a Perl false value to indicate that hashes should not be calculated, if performance is a concern.
- no_compress_comment
-
If not set to a true value it is allowed to set a HTML comment that prevents the input being packed.
<!-- HTML::Packer _no_compress_ -->
Is not set by default.
- html5
-
If set to a true value closing slashes will be removed from void elements.
- csp
-
If
do_csp
is set to'sha256'
, returns a hash that looks like this:( 'script-src' => [qw( sha256-...= sha256-...= )], 'style-src' => [qw( sha256-...= sha256-...= )], )
with each element of the
ARRAY
refs containing a CSP-friendly hash for a<script>
or<style>
tag.
AUTHOR
Merten Falk, <nevesenin at cpan.org>
. Now maintained by Lee Johnson (LEEJO) with contributions from:
Alexander Krizhanovsky <ak@natsys-lab.com>
Bas Bloemsaat <bas@bloemsaat.com>
girst <girst@users.noreply.github.com>
Ankit Pati (ANKITPATI) <contact@ankitpati.in>
BUGS
Please report any bugs or feature requests through the web interface at https://github.com/leejo/html-packer-perl/issues. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
SUPPORT
You can find documentation for this module with the perldoc command.
perldoc HTML::Packer
COPYRIGHT & LICENSE
Copyright 2009 - 2011 Merten Falk, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.