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

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