HTML::WikiConverter::NUserlContributed Perl HTML::WikiConverter::Normalizer(3)NAMEHTML::WikiConverter::Normalizer - Convert CSS styles to (roughly)
corresponding HTML
SYNOPSIS
use HTML::TreeBuilder;
use HTML::WikiConverter::Normalizer;
my $tree = new HTML::TreeBuilder();
$tree->parse( '<p><font style="font-style:italic; font-weight:bold">text</font></p>' );
my $norm = new HTML::WikiConverter::Normalizer();
$norm->normalize($tree);
# Roughly gives "<p><font><b><i>text</i></b></font></p>"
print $tree->as_HTML();
DESCRIPTION
HTML::WikiConverter dialects convert HTML into wiki markup. Most (if
not all) know nothing about CSS, nor do they take it into consideration
when performing html-to-wiki conversion. But there is no good reason
for, say, "<font style="font-weight:bold">text</font>" not to be
converted into '''text''' in the MediaWiki dialect. The same is true of
other dialects, all of which should be able to use CSS information to
produce wiki markup.
The issue becomes especially problematic when considering that several
WYSIWYG HTML editors (e.g. Mozilla's) produce this sort of CSS-heavy
HTML. Prior to "HTML::WikiConverter::Normalizer", this HTML would have
been essentially converted to text, the CSS information having been
ignored by "HTML::WikiConverter".
"HTML::WikiConverter::Normalizer" avoids this with a few simple
transformations that convert CSS styles into HTML tags.
METHODS
new
my $norm = new HTML::WikiConverter::Normalizer();
Constructs a new normalizer
normalize
$norm->normalize($elem);
Normalizes $elem and all its descendents, where $elem is an
HTML::Element object.
SUBCLASSING
The following methods may be useful to subclasses.
handlers
my $handlers = $self->handlers;
Class method returning reference to an array of handlers used to
convert CSS to HTML. Each handler is a hashref that specifies the CSS
properties and values to match, and the HTML tags and attributes the
matched properties will be converted to.
The "type", "name", "value", and "tag" keys may be used to match an
element's property or attribute. "type" may be either "css" if matching
a CSS property (in which case "name" must contain the name of the
property, and "value" must contain the property value to match) or
"attr" if matching an HTML tag attribute (in which case "name" must
contain the name of the attribute, and "value" must contain the
attribute value to match).
"value" may be a string (for an exact match), regex (which will be used
to match against the element's property or attribute value), coderef
(which will be passed the property or attribute value and is expected
to return true on match, false otherwise), or "*" (which matches any
property or attribute value). A tag or list of tags can also be matched
with the "tag" key, which takes either a string or an arrayref.
To specify what actions the handler will take, the "new_tag",
"new_attr", and "normalizer" keys are used. "new_tag" is required and
indicates the name of the tag that will be created. "attribute" is
optional and indicates the name of the attribute in the new tag that
will take the value of the original CSS property. If a coderef is given
as the "normalizer", it will be passed the value of the
property/attribute and should return one suitable to be assigned to the
new tag attribute.
SEE ALSO
CSS
AUTHOR
David J. Iberri, "<diberri@cpan.org>"
BUGS
Please report any bugs or feature requests to "bug-html-wikiconverter
at rt.cpan.org", or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter>. I
will be notified, and then you'll automatically be notified of progress
on your bug as I make changes.
COPYRIGHT & LICENSE
Copyright 2006 David J. Iberri, all rights reserved.
This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
perl v5.14.12009-01-31HTML::WikiConverter::Normalizer(3)
