HTML::...ddmuse(3pm)

🌸 NAME 🌸

HTML::WikiConverter::Oddmuse — the lil glow-up module that turns your HTML into Oddmuse markup. bestie it literally says it right there in the name 💅

---

✨ SYNOPSIS ✨

okay so here's the whole vibe in three lines, no cap:

use HTML::WikiConverter;
my $wc = new HTML::WikiConverter( dialect => 'Oddmuse' );
print $wc->html2wiki( $html );

that's it. that's the whole thing. slay 🫶

---

💖 DESCRIPTION 💖

so this module is literally the rulebook for converting HTML into Oddmuse markup 📖✨ It's a dialect module, which means it supports most of Oddmuse's text formatting rules (the ones described over at [1], iykyk), and notably it handles:

• bold, strong, italic, emphasized, and <u>underlined</u> text 💅
• paragraph blocks
• external images 🖼️
• internal and external links 🔗
• unordered and ordered lists 📝
• tables [2]

and the receipts for those two footnotes:

• [1] http://www.oddmuse.org/cgi-bin/wiki/Text_Formatting_Rules
• [2] http://www.oddmuse.org/cgi-bin/wiki/Table_Markup_Extension

for the actual usage deets, go peek at HTML::WikiConverter — it's giving main character energy for real 🌈

---

👑 ATTRIBUTES 👑

so besides the regular set of attributes that the HTML::WikiConverter constructor already recognizes, this dialect is like "and one more thing 💅" and also accepts these:

🐪 camel_case

a Boolean that says whether CamelCase links are enabled in the target Oddmuse installation. This one corresponds to Oddmuse's $WikiLinks configuration parameter, fr fr 🎀

turning CamelCase links on will take HTML like this:

<p><a href="/wiki/CamelCase">CamelCase</a> links are fun.</p>

and glow it up into this Oddmuse markup:

CamelCase links are fun.

turning CamelCase links off — which is the default, bestie, don't forget 😌 — would convert that same HTML into:

[[CamelCase]] links are fun.

see how the brackets showed up? yeah. that's the difference. periodt 💜

---

🦋 AUTHOR 🦋

David J. Iberri, "<diberri at cpan.org>" — thank you king, we owe you our whole wiki conversion pipeline 🙏✨

---

💀 BUGS 💀

if you found a bug or you're craving a feature, pls pls pls report it to "bug-html-wikiconverter-oddmuse at rt.cpan.org" — or you can go through the web interface right here:

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter-Oddmuse

and here's the cute part: I will be notified 👀 and then you'll automatically be notified of progress on your bug as changes get made. it's a whole group chat situation, we're both in the loop 🫶

---

🌈 SUPPORT 🌈

you can find the documentation for this module with the perldoc command:

perldoc HTML::WikiConverter::Oddmuse

and you can also go looking for info at these iconic spots:

• AnnoCPAN: Annotated CPAN documentation 📚

http://annocpan.org/dist/HTML-WikiConverter-Oddmuse

• CPAN Ratings ⭐

http://cpanratings.perl.org/d/HTML-WikiConverter-Oddmuse

• RT: CPAN's request tracker 🎫

http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-WikiConverter-Oddmuse

• Search CPAN 🔍

http://search.cpan.org/dist/HTML-WikiConverter-Oddmuse

---

🎀 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. so like. go off, share it, remix it, the license said yes 💅✨

---

and that's the whole page bestie!! 🌸 this beauty shipped as part of perl v5.36.0 and the page is dated 2022-12-12 — and yeah the manual name got a lil scrunch, it's HTML::...ddmuse(3pm) if you need to cite it in your essay. ily, go convert some HTML 🫶💜