Thoughts from the abyss

I found a cool Perl module set the other day. It’s takes plain old HTML and converts it to whatever wiki format you specify. This is perferct if you have documentation in HTML, or whatever documents for that matter, that you want to post to wikis. I’ve been using it the past week or so to convert HTML pages to MoinMoin format for the CentOS wiki. I didn’t look long and hard to find RPMs for installing it across yum, so I just installed it from Perl CPAN.

# perl -MCPAN -e shell
cpan> i /HTML-WikiConverter/

Fetching with LWP:
  ftp://ftp.uwsg.iu.edu/pub/perl/CPAN/modules/03modlist.data.gz
Going to read /root/.cpan/sources/modules/03modlist.data.gz
Going to write /root/.cpan/Metadata
Distribution    D/DI/DIBERRI/HTML-WikiConverter-0.61.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-Confluence-0.01.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-DokuWiki-0.53.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-Kwiki-0.51.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-Markdown-0.02.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-MediaWiki-0.55.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-MoinMoin-0.53.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-Oddmuse-0.52.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-PhpWiki-0.51.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-PmWiki-0.51.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-SnipSnap-0.50.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-TikiWiki-0.50.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-UseMod-0.50.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-WakkaWiki-0.50.tar.gz
Distribution    D/DI/DIBERRI/HTML-WikiConverter-WikkaWiki-0.50.tar.gz
Distribution    D/DS/DSCHAEFER/HTML-WikiConverter-PbWiki-0.01.tar.gz
Distribution    P/PA/PACKI/HTML-WikiConverter-XWiki-0.01.tar.gz
Distribution    S/SY/SYNEDRA/HTML-WikiConverter-Socialtext-0.03.tar.gz
18 items found

You have all those choices for your wiki formats, so install whichever ones you want to use.

cpan> install HTML::WikiConverter HTML::WikiConverter::MoinMoin HTML::WikiConverter::DokuWiki

Once installed, you can use it from the command line as such.

# html2wiki --dialect MoinMoin input_file.html > output_file.wiki.txt

Presto, HTML to wiki markup. Obviously there are many more options, so html2wiki –help to check everything out.