HTML::WikiConverter::MediaWiki.3pm

Langue: en

Autres versions - même langue

Version: 2006-09-17 (ubuntu - 08/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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 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 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.