NAME¶
HTML::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>. 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.