HTML::WikiConverter version 0.23
================================

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
  PhpWiki
  PmWiki
  UseMod

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 script:

  % 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
  * URI for handling URIs in links
  * Getopt::Long for html2wiki's command line interface

CHANGES

  Version 0.23
    * add DocuWiki dialect (with thanks to Thomas J. Messenger)
    * (bug 12441) allow dialects to post-process wiki markup
    * (bug 12440) add 'empty' rule for elements with no content
    * (bug 12439) unknown HTML elements no longer ignored
    * (bug 12396) added command line tool bin/html2wiki
    * (bug 12395) MoinMoin: added post-processing step in MoinMoin
                  dialect to replace "URL[[BR]]" with "URL [[BR]]"
    * (bug 12433) MediaWiki: added missing attributes for <tr>; included
                  complete set of whitelisted tags and attributes from
                  Sanitizer.php
  Version 0.22
    * Added 'wrap_in_html' argument so HTML fragments aren't ignored
      by HTML::TreeBuilder
    * Escaped bracketed content that shouldn't be interpreted as an
      external link reference in MediaWiki
    * Added 'html2wiki' command line interface
  Version 0.21
    * Lots of documentation cleanup
    * Fixed whitespace trimming bug that broke certain markup
    * Added support for table, row, and cell attributes and internal
      links in MediaWiki dialect
    * Added wiki link support using the 'wiki_uri' argument
    * Added PmWiki dialect; http://www.pmwiki.org
  Version 0.20
    * New implementation with API changes
    * Added support for Kwiki, MediaWiki, MoinMoin, PhpWiki, and
      UseMod wiki dialects

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
