package Mason::Plugin::HTMLFilters;
BEGIN {
  $Mason::Plugin::HTMLFilters::VERSION = '0.01';
}
use Moose;
with 'Mason::Plugin';

1;

__END__

=head1 NAME

Mason::Plugin::HTMLFilters - Filters related to HTML generation

=head1 FILTERS

=over

=item HTML or H

Do a basic HTML escape on the content - just the characters '&', '>', '<', and
'"'.

    <input name="company" value="<% $company | H %>">

=item HTMLEntities

Do a comprehensive HTML escape on the content, using
HTML::Entities::encode_entities.

=item URI or U

URI-escape the content.

    <a href="<% $url | U %>">

=item HTMLPara

Formats a block of text into HTML paragraphs.  A sequence of two or more
newlines is used as the delimiter for paragraphs which are then wrapped in HTML
""<p>""...""</p>"" tags. Taken from L<Template::Toolkit|Template>. e.g.

    <% $.HTMLPara { %>
    First paragraph.
      
    Second paragraph.
    </%>
    
outputs:

    <p>
    First paragraph.
    </p>
      
    <p>
    Second paragraph.
    </p>

=item HTMLParaBreak

Similar to HTMLPara above, but uses the HTML tag sequence "<br><br>" to join
paragraphs. Taken from L<Template::Toolkit|Template>. e.g.

    <% $.HTMLPara { %>
    First paragraph.
      
    Second paragraph.
    </%>
    
outputs:

    First paragraph.
    <br><br>
    Second paragraph.

=back

=head1 SEE ALSO

L<Mason|Mason>

=cut
