HTML::WikiConverter version 0.51
================================

HTML::WikiConverter is an HTML to wiki converter capable of converting
HTML source into a variety of wiki dialects. It's aimed at folks who
are converting vanilla HTML websites into wikis.

The following dialects are supported:

  DokuWiki    Kwiki
  MediaWiki   MoinMoin
  Oddmuse     PhpWiki
  PmWiki      SnipSnap
  TikiWiki    UseMod
  WakkaWiki   WikkaWiki

INSTALLATION

As of version 0.50, HTML::WikiConverter is just an interface to
individual dialect modules; it no longer ships with all its wiki
dialects. To install the latest version of HTML::WikiConverter and all
its dialects, install Bundle::HTMLWikiConverter from CPAN:

  % perl -MCPAN -e 'install Bundle::HTMLWikiConverter'

For just the HTML::WikiConverter interface:

  % perl -MCPAN -e 'install HTML::WikiConverter'

Individual dialects can be installed separately; for example:

  % perl -MCPAN -e 'install HTML::WikiConverter::MediaWiki'
  % perl -MCPAN -e 'install HTML::WikiConverter::PhpWiki'

SYNOPSIS

Converting HTML to wiki markup is easy:

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

Or via the command-line with the included utility:

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

There's also a web interface if you're so inclined:

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

UNICODE SUPPORT

As of version 0.40, HTML::WikiConverter supports multiple character
encodings via the 'encodings' attribute.

PREREQUISITES

  * Test::More for testing
  * HTML::TreeBuilder for building and manipulating HTML trees
  * HTML::Entities for encoding HTML entities
  * URI and URI::Escape for handling URIs in links

CHANGES IN VERSION 0.51

  * Add available_dialects() class method
  * Add 'preprocess' attribute so client can preprocess HTML tree
    before conversion
  * Allow regexps and multiple URIs in 'wiki_uri' attribute
  * Add 'wiki_page_extractor' attribute so client can more
    flexibly (than the 'wiki_uri' attribute) specify how wiki page
    titles are extracted from URIs
  * Make prettier URIs with URI::Escape

ACKNOWLEDGEMENTS

Thanks to Tatsuhiko Miyagawa for suggestions and code.

COPYRIGHT

Copyright (c) 2004-2006 David J. Iberri <diberri@cpan.org>

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
