NAME
HTML::WikiConverter - An HTML-to-wiki markup converter
SYNOPSIS
use HTML::WikiConverter;
my $wc = new HTML::WikiConverter(
html => $html_source,
dialect => 'MediaWiki'
);
print $wc->output, "\n";
DESCRIPTION
HTML::WikiConverter provides simple conversion from HTML source to
wiki markup. A sample web interface is available at
http://diberri.dyndns.org/html2wiki.html
if you would like to try the module before you install it.
NEW IN VERSION 0.14
o Support for adding wiki dialects (e.g., MediaWiki, PhpWiki)
FEATURES
In addition to converting most HTML tags into corresponding wiki
markup, HTML::WikiConverter offers a few extra features:
o Supports image thumbnails
If an IMG tag is found with a WIDTH attribute that differs from
the actual width of the image, then the resulting [[Image:]]
markup will contain the "thumb" keyword followed by the
thumbnail width.
o Recognizes DIVs used to align images
If an IMG tag (or an IMG contained within an A tag) is the only
child element of a DIV that uses STYLE or CLASS to align the
image, then the alignment is taken from the DIV and placed in
the [[Image:]] markup.
o Supports table attributes
Attributes for table tags (TABLE, TR, etc.) will be added
appropriately to the resulting table markup.
o Tidies wiki markup
Attempts to remove unnecessary (and often ugly) spacing between
chunks of HTML. Text contained within PRE tags is left
untouched.
o Supports Unicode
Translates high bit characters to their HTML entity equivalents,
in this module's first attempt at supporting Unicode.
o Supports separate wiki dialects
Translates HTML source into a variety of wiki dialects, with
plug-in interface using HTML::WikiConverter::Dialect.
INSTALLATION
The simplest way to install is via the CPAN shell:
cpan> install HTML::WikiConverter
The next best thing is:
> perl Makefile.PL
> make
> make test
> make install
Installing wiki dialects is similar:
cpan> install HTML::WikiConverter::Dialect::MediaWiki
AUTHOR
David J. Iberri
COPYRIGHT
Copyright (c) 2004 David J. Iberri
This program 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