HTML::WikiConverter version 0.30
================================

HTML::WikiConverter is an HTML to wiki converter capable of
converting HTML source into a variety of wiki dialects. Supported
dialects include:

  DocuWiki    Kwiki
  MediaWiki   MoinMoin
  Oddmuse     PhpWiki
  PmWiki      SnipSnap
  TikiWiki    UseMod
  WakkaWiki

Converting HTML to wiki markup is easy:

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

You can even use the convenient command line interface:

  % html2wiki --dialect MediaWiki input.html > output.mw

COMMITTMENT ISSUES?

Try before you buy:

  http://diberri.dyndns.org/html2wiki.html

INSTALLATION

The easiest way to install this module is via the CPAN shell:

  % cpan HTML::WikiConverter

Or if you'd prefer:

  % perl Makefile.PL
  % make
  % make test
  % make install

DEPENDENCIES

  * HTML::Tree for building and manipulating HTML trees
  * HTML::Entities for encoding HTML entities
  * URI for handling URIs in links
  * Getopt::Long for html2wiki's command line interface

CHANGES IN VERSION 0.30

  * add support for WakkaWiki, SnipSnap, Oddmuse, and TikiWiki (see http://c2.com/cgi/wiki?TopTenWikiEngines)
  * add DocuWiki support for links, blockquotes, images, and tables
  * add 'strip_scripts', 'strip_head', and 'strip_comments' options, on by default
  * allow reading from HTML files using "html2wiki( file => ... )"
  * (bug 12944, 12303) preserve HTML entities in text nodes
  * (bug 13017) MediaWiki should allow <i> and <b> to be preserved rather than converting to '' and '''
  * backend API changes; dialect modules now subclass HTML::WikiConverter
  * more complete tests using larger input HTML file
  * document individual dialects
  * lots of documentation fixes

COPYRIGHT

Copyright (c) 2004-2005 David J. Iberri

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html
