~ubuntu-branches/ubuntu/oneiric/libhtml-wikiconverter-perl/oneiric

 

HTML::WikiConverter is a Perl module for converting HTML to wiki markup for a variety of different wiki engines. Currently, it supports __eleven__ dialects:

 

 

I'd ~~really~~ like to add support for TWiki, but the way it handles ~~__bold italics__~~ (and possibly other nested elements) is very disappointing.

 

 

It's very easy to use HTML::WikiConverter. Grab a copy from your favorite {link:CPAN mirror|http://www.cpan.org} and then run something like this:

 

 

Alternatively, you might want to try HTML::WikiConverter's command line interface; it's a program called html2wiki and it's stored in ~~bin/html2wiki~~.

 

 

Unfortunately, I haven't managed to implement every feature of each supported dialect. My initial goal was simply to create a converter for MediaWiki (I am a Wikipediholic, after all :-), but then PhpWiki's Reini Urban suggested that I be more ambitious and provide the dialect interface. And so far I've been really happy with the progress.

 

 

Of course there are always bugs. Luckily, CPAN comes to the rescue again with its {link:bug tracking service|http://rt.cpan.org} for module authors.

 

Aplysia california | California | Deep red-colored sea hare | Red and brown seaweed

{table}

 

 

 

Many dialects allow embedded images, either from local or remote stores.

 

 

Wikis also support lists, even extensively nested ones. Some rely on leading characters to determine nest levels, while others rely on spaces or (egad!) tabs.

 

** 1a

111. fee

111. fie

 

Some wikis support definition lists, though they're often used inappropriately (as in MediaWiki, which uses them for indentation).