Difference between revisions of "API:EPrints/Test/Pod2Wiki"
(Blanked the page) |
|||
Line 1: | Line 1: | ||
+ | <!-- Pod2Wiki=_preamble_ | ||
+ | This page has been automatically generated from the EPrints 3.2 source. Any wiki changes made between the 'Pod2Wiki=*' and 'Edit below this comment' comments will be lost. | ||
+ | -->{{API}}{{Pod2Wiki}}{{API:Source|file=EPrints/Test/Pod2Wiki.pm|package_name=EPrints::Test::Pod2Wiki}}[[Category:API|Pod2Wiki]]<div><!-- Edit below this comment --> | ||
+ | |||
+ | <!-- Pod2Wiki=_private_ --><!-- Pod2Wiki=head_name --> | ||
+ | ==NAME== | ||
+ | EPrints::Test::Pod2Wiki - convert EPrints pod to MediaWiki | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=head_editing_pod2wiki_pages --> | ||
+ | ==Editing Pod2Wiki Pages== | ||
+ | Pages generated by this module have Pod2Wiki markers inserted. These markers are HTML comments that start and end every {{API:PodLink|file=perlpod|package_name=perlpod|section=|text=Plain Old Documentation}} (POD) section. For example a POD synopsis section will look like this: | ||
+ | |||
+ | <!-- Pod2Wiki=head_synopsis --> | ||
+ | ==SYNOPSIS== | ||
+ | use EPrints::Test::Pod2Wiki; | ||
+ | my $p = EPrints::Test::Pod2Wiki-&gt;new( | ||
+ | wiki_index =&gt; "http://wiki.foo.org/index.php", | ||
+ | username =&gt; "johnd", | ||
+ | password =&gt; "xiPi00", | ||
+ | ); | ||
+ | $p-&gt;update_page( "EPrints::Utils" ); | ||
+ | <!-- Edit below this comment --> | ||
+ | <!-- Pod2Wiki= --> | ||
+ | |||
+ | When the Wiki page is updated each Pod2Wiki section is replaced with the equivalent section content from the POD. | ||
+ | |||
+ | Comments can be made by adding them to the comment sections: | ||
+ | |||
+ | ... | ||
+ | <!-- Pod2Wiki=head_methods --> | ||
+ | ==METHODS== | ||
+ | Any changes here will be lost | ||
+ | <!-- Edit below this comment --> | ||
+ | This Wiki comment will be kept. | ||
+ | <!-- Pod2Wiki= --> | ||
+ | ... | ||
+ | |||
+ | Note: if a POD section is removed any Wiki content associated with that section will also be removed. | ||
+ | |||
+ | The rest of this page concerns the <em>EPrints::Test::Pod2Wiki</em> module. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=head_synopsis --> | ||
+ | ==SYNOPSIS== | ||
+ | use EPrints::Test::Pod2Wiki; | ||
+ | |||
+ | my $p = EPrints::Test::Pod2Wiki->new( | ||
+ | wiki_index => "http://wiki.foo.org/index.php", | ||
+ | username => "johnd", | ||
+ | password => "xiPi00", | ||
+ | ); | ||
+ | |||
+ | $p->update_page( "EPrints::Utils" ); | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=head_description --> | ||
+ | ==DESCRIPTION== | ||
+ | This module enables the integration of EPrints POD (documentation) and MediaWiki pages. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=head_methods --> | ||
+ | ==METHODS== | ||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_new --> | ||
+ | ===EPrints::Test::Pod2Wiki->new( ... )=== | ||
+ | |||
+ | Create a new Pod2Wiki parser. Required options: | ||
+ | |||
+ | wiki_index - URL of the MediaWiki "index.php" page | ||
+ | username - MediaWiki username | ||
+ | password - MediaWiki password | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_update_page --> | ||
+ | ===$ok = $pod->update_page( $package_name )=== | ||
+ | |||
+ | Update the MediaWiki page for $package_name. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_command --> | ||
+ | ===$parser->command( ... )=== | ||
+ | |||
+ | {{API:PodLink|file=Pod/Parser|package_name=Pod::Parser|section=|text=Pod::Parser}} callback. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_verbatim --> | ||
+ | ===$parser->verbatim( ... )=== | ||
+ | |||
+ | {{API:PodLink|file=Pod/Parser|package_name=Pod::Parser|section=|text=Pod::Parser}} callback. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_textblock --> | ||
+ | ===$parser->textblock( ... )=== | ||
+ | |||
+ | {{API:PodLink|file=Pod/Parser|package_name=Pod::Parser|section=|text=Pod::Parser}} callback. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_interpolate --> | ||
+ | ===$parser->interpolate( ... )=== | ||
+ | |||
+ | {{API:PodLink|file=Pod/Parser|package_name=Pod::Parser|section=|text=Pod::Parser}} callback. Overloaded to also escape HTML entities. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=item_interior_sequence --> | ||
+ | ===$parser->interior_sequence( ... )=== | ||
+ | |||
+ | {{API:PodLink|file=Pod/Parser|package_name=Pod::Parser|section=|text=Pod::Parser}} callback. | ||
+ | |||
+ | <div style='background-color: #e8e8f; margin: 0.5em 0em 1em 0em; border: solid 1px #cce; padding: 0em 1em 0em 1em; font-size: 80%; '> | ||
+ | <span style='display:none'>User Comments</span> | ||
+ | <!-- Edit below this comment --> | ||
+ | |||
+ | |||
+ | <!-- Pod2Wiki= --> | ||
+ | </div> | ||
+ | <!-- Pod2Wiki=_postamble_ --><!-- Edit below this comment --> |
Revision as of 13:01, 25 February 2010
EPrints 3 Reference: Directory Structure - Metadata Fields - Repository Configuration - XML Config Files - XML Export Format - EPrints data structure - Core API - Data Objects
Latest Source Code (3.4, 3.3) | Revision Log | Before editing this page please read Pod2Wiki
NAME
EPrints::Test::Pod2Wiki - convert EPrints pod to MediaWiki
Editing Pod2Wiki Pages
Pages generated by this module have Pod2Wiki markers inserted. These markers are HTML comments that start and end every Plain Old Documentation (POD) section. For example a POD synopsis section will look like this:
<!-- Pod2Wiki=head_synopsis --> ==SYNOPSIS== use EPrints::Test::Pod2Wiki; my $p = EPrints::Test::Pod2Wiki->new( wiki_index => "http://wiki.foo.org/index.php", username => "johnd", password => "xiPi00", ); $p->update_page( "EPrints::Utils" ); <!-- Edit below this comment --> <!-- Pod2Wiki= -->
When the Wiki page is updated each Pod2Wiki section is replaced with the equivalent section content from the POD.
Comments can be made by adding them to the comment sections:
... <!-- Pod2Wiki=head_methods --> ==METHODS== Any changes here will be lost <!-- Edit below this comment --> This Wiki comment will be kept. <!-- Pod2Wiki= --> ...
Note: if a POD section is removed any Wiki content associated with that section will also be removed.
The rest of this page concerns the EPrints::Test::Pod2Wiki module.
SYNOPSIS
use EPrints::Test::Pod2Wiki; my $p = EPrints::Test::Pod2Wiki->new( wiki_index => "http://wiki.foo.org/index.php", username => "johnd", password => "xiPi00", ); $p->update_page( "EPrints::Utils" );
DESCRIPTION
This module enables the integration of EPrints POD (documentation) and MediaWiki pages.
METHODS
EPrints::Test::Pod2Wiki->new( ... )
Create a new Pod2Wiki parser. Required options:
wiki_index - URL of the MediaWiki "index.php" page username - MediaWiki username password - MediaWiki password
$ok = $pod->update_page( $package_name )
Update the MediaWiki page for $package_name.
$parser->command( ... )
Pod::Parser callback.
$parser->verbatim( ... )
Pod::Parser callback.
$parser->textblock( ... )
Pod::Parser callback.
$parser->interpolate( ... )
Pod::Parser callback. Overloaded to also escape HTML entities.
$parser->interior_sequence( ... )
Pod::Parser callback.