HTML::Tidy - Web validation in a Perl object |
new()
messages()
clear_messages()
HTML::Tidy - Web validation in a Perl object
Version 1.06
use HTML::Tidy;
my $tidy = HTML::Tidy->new( {config_file => 'path/to/config'} ); $tidy->ignore( type => TIDY_WARNING ); $tidy->parse( "foo.html", $contents_of_foo );
for my $message ( $tidy->messages ) { print $message->as_string; }
HTML::Tidy
is an HTML checker in a handy dandy object. It's meant as
a replacement for the HTML::Lint manpage. If you're currently an the HTML::Lint manpage
user looking to migrate, see the section Converting from HTML::Lint.
Message types TIDY_WARNING
and TIDY_ERROR
.
Everything else is an object method.
new()
Create an HTML::Lint object.
my $tidy = HTML::Tidy->new();
Optionally you can give a hashref of configuration parms. Currently,
only config_file
is supported.
my $tidy = HTML::Tidy->new( {config_file => 'path/to/tidy.cfg'} );
This configuration file will be read and used when you clean an HTML file.
messages()
Returns the messages accumulated.
clear_messages()
Clears the list of messages, in case you want to print and clear, print and clear. If you don't clear the messages, then each time you call parse() you'll be accumulating more in the list.
Specify types of messages to ignore. Note that the ignore flags must be
set before calling parse()
. You can call ignore()
as many times
as necessary to set up all your restrictions; the options will stack up.
TIDY_(WARNING|ERROR)
$tidy->ignore( type => TIDY_WARNING );
$tidy->ignore( text => qr/DOCTYPE/ ); $tidy->ignore( text => [ qr/unsupported/, qr/proprietary/i ] );
Parses a string, or list of strings, that make up a single HTML file.
The $filename parm is only used as an identifier for your use. The file is not actually read and opened.
Returns true if all went OK, or false if there was some problem calling tidy, or parsing tidy's output.
Cleans a string, or list of strings, that make up a single HTML file.
Returns true if all went OK, or false if there was some problem calling tidy, or parsing tidy's output.
the HTML::Tidy manpage is different from the HTML::Lint manpage in a number of crucial ways.
HTML::Tidy
is mostly a happy wrapper around libtidy.
Test::
counterpartTest::HTML::Lint
, but
the Test::HTML::Tidy manpage is a separate distribution. This saves the people
who don't want the Test::
framework from pulling it in, and all its
prerequisite modules.
I welcome your comments and suggestions. Please send them to
<bug-html-tidy at rt.cpan.org>
so that they can be tracked in the
RT ticket tracking system.
Andy Lester, <andy at petdance.com>
Copyright (C) 2005 by Andy Lester
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.1 or, at your option, any later version of Perl 5 you may have available.
HTML::Tidy - Web validation in a Perl object |