GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  HTML::WIKICONVERTER::NORMALIZER (3)

.ds Aq ’

NAME

HTML::WikiConverter::Normalizer - Convert CSS styles to (roughly) corresponding HTML

CONTENTS

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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 HTML::WIKICONVERTER::NORMALIZER (3) 2009-01-31

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.