Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HTML::WikiConverter::NUserlContributed Perl HTML::WikiConverter::Normalizer(3)

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.

perl v5.32.1			  2009-01-31HTML::WikiConverter::Normalizer(3)

NAME | SYNOPSIS | DESCRIPTION | METHODS | SUBCLASSING | SEE ALSO | AUTHOR | BUGS | COPYRIGHT & LICENSE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=HTML::WikiConverter::Normalizer&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help