HTML::...malizer(3pm)

💖 HTML::WikiConverter::Normalizer 💖

okay bestie, gather round — this is the manual page for HTML::WikiConverter::Normalizer, which lives in the Perl docs as HTML::...malizer(3pm) (they truncated it, tragic, but we move). It's giving "convert CSS styles to (roughly) corresponding HTML" and honestly? iconic behaviour.

---

✨ 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 🦋

So here's the tea ☕ — HTML::WikiConverter dialects convert HTML into wiki markup. Most of them (if not literally all, ngl) know absolutely nothing about CSS, and they do not take it into consideration when they're doing that html-to-wiki conversion. But like… there is no good reason for, say, "<font style="font-weight:bold">text</font>" to not get converted into '''text''' in the MediaWiki dialect. Same energy for every other dialect — all of them should be able to use CSS info to produce wiki markup. periodt.

And it gets especially messy when you remember that several WYSIWYG HTML editors (looking at you, Mozilla's 👀) produce exactly this sort of CSS-heavy HTML. Before "HTML::WikiConverter::Normalizer" existed, this HTML would've been essentially converted to text, with all the CSS information just… ignored by "HTML::WikiConverter". 💀

"HTML::WikiConverter::Normalizer" dodges all of that with a few simple transformations that convert CSS styles into HTML tags. slay.

---

🎀 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. yes bestie, all of them. 🫶

---

🌈 SUBCLASSING 🌈

The following methods may be useful to subclasses. (hi subclasses, love u 💜)

🌟 handlers

my $handlers = $self->handlers;

Class method returning a 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 this case "name" must contain the name of the property, and "value" must contain the property value to match. 🎨
• "attr" — if matching an HTML tag attribute. In this case "name" must contain the name of the attribute, and "value" must contain the attribute value to match. 🏷️

"value" can be a whole bunch of things, and it's lowkey the most flexible part:

• a string — for an exact match
• a regex — which will be used to match against the element's property or attribute value
• a coderef — which will be passed the property or attribute value and is expected to return true on match, false otherwise
• "*" — 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.

no cap, "new_tag" really is required. don't skip it. 🙈

---

👀 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. fr fr, the loop closes. 🔁

---

📜 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.

---

and that's the whole page, bestie 🫶 this was pulled from perl v5.34.0, dated 2022-06-14 — documented under HTML::...malizer(3pm), mwah 💋✨