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

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.