NAME¶
HTML::WikiConverter::MediaWiki - Convert HTML to MediaWiki markup
SYNOPSIS¶
use HTML::WikiConverter;
my $wc = new HTML::WikiConverter( dialect => 'MediaWiki' );
print $wc->html2wiki( $html );
DESCRIPTION¶
This module contains rules for converting HTML into MediaWiki markup. See
HTML::WikiConverter for additional usage details.
ATTRIBUTES¶
In addition to the regular set of attributes recognized by the
HTML::WikiConverter constructor, this dialect also accepts the following
attributes:
preserve_bold¶
Boolean indicating whether bold HTML elements should be preserved as HTML in the
wiki output rather than being converted into MediaWiki markup.
By default, <b> and <strong> elements are converted to wiki markup
identically. But sometimes you may wish <b> tags in the HTML to be
preserved in the resulting MediaWiki markup. This attribute allows this.
For example, if "preserve_bold" is enabled, HTML like
<ul>
<li> <b>Bold</b>
<li> <strong>Strong</strong>
</ul>
will be converted to
* <b>Bold</b>
* '''Strong'''
When disabled (the default), the preceding HTML markup would be converted into
* '''Bold'''
* '''Strong'''
preserve_italic¶
Boolean indicating whether italic HTML elements should be preserved as HTML in
the wiki output rather than being converted into MediaWiki markup.
For example, if "preserve_italic" is enabled, HTML like
<ul>
<li> <i>Italic</i>
<li> <em>Emphasized</em>
</ul>
will be converted to
* <i>Italic</i>
* ''Emphasized''
When disabled (the default), the preceding HTML markup would be converted into
* ''Italic''
* ''Emphasized''
preserve_templates¶
Boolean indicating whether "{{template}}" calls found in HTML should
be preserved in the wiki markup. If disabled (the default), templates calls
will be wrapped in "<nowiki>" tags.
preserve_nowiki¶
Boolean indicating whether "<nowiki>" tags found in HTML should
be preserved in the wiki markup. If disabled (the default), nowiki tags will
be replaced with their content.
pad_headings¶
Boolean indicating whether section headings should be padded with spaces (eg,
"== Section ==" instead of "==Section=="). Default is
false (ie, not to pad).
AUTHOR¶
David J. Iberri, "<diberri at cpan.org>"
BUGS¶
Please report any bugs or feature requests to
"bug-html-wikiconverter-mediawiki at rt.cpan.org", or through the
web interface at
<
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=HTML-WikiConverter-MediaWiki>.
I will be notified, and then you'll automatically be notified of progress on
your bug as I make changes.
SUPPORT¶
You can find documentation for this module with the perldoc command.
perldoc HTML::WikiConverter::MediaWiki
You can also look for information at:
- •
- AnnoCPAN: Annotated CPAN documentation
<http://annocpan.org/dist/HTML-WikiConverter-MediaWiki>
- •
- CPAN Ratings
<http://cpanratings.perl.org/d/HTML-WikiConverter-MediaWiki>
- •
- RT: CPAN's request tracker
<http://rt.cpan.org/NoAuth/Bugs.html?Dist=HTML-WikiConverter-MediaWiki>
- •
- Search CPAN
<http://search.cpan.org/dist/HTML-WikiConverter-MediaWiki>
COPYRIGHT & LICENSE¶
Copyright 2006 David J. Iberri, all rights reserved.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.