Difference between revisions of "API:EPrints/Test/Pod2Wiki"

From EPrints Documentation
Jump to: navigation, search
(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= -->
 
</div>
 
 
<!-- 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:
 
 
  &lt;!-- Pod2Wiki=head_synopsis --&gt;
 
  ==SYNOPSIS==
 
  use EPrints::Test::Pod2Wiki;
 
  my $p = EPrints::Test::Pod2Wiki-&amp;gt;new(
 
    wiki_index =&amp;gt; "http://wiki.foo.org/index.php",
 
    username =&amp;gt; "johnd",
 
    password =&amp;gt; "xiPi00",
 
  );
 
  $p-&amp;gt;update_page( "EPrints::Utils" );
 
  &lt;!-- Edit below this comment --&gt;
 
  &lt;!-- Pod2Wiki= --&gt;
 
 
 
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:
 
 
  ...
 
  &lt;!-- Pod2Wiki=head_methods --&gt;
 
  ==METHODS==
 
  Any changes here will be lost
 
  &lt;!-- Edit below this comment --&gt;
 
  This Wiki comment will be kept.
 
  &lt;!-- Pod2Wiki= --&gt;
 
  ...
 
 
 
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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- 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" );
 
 
 
<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= -->
 
</div>
 
 
<!-- 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= -->
 
</div>
 
 
<!-- 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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_new -->
 
===EPrints::Test::Pod2Wiki-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_update_page -->
 
===$ok = $pod-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_command -->
 
===$parser-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_verbatim -->
 
===$parser-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_textblock -->
 
===$parser-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_interpolate -->
 
===$parser-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=item_interior_sequence -->
 
===$parser-&gt;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= -->
 
</div>
 
 
<!-- Pod2Wiki= -->
 
</div>
 
<!-- Pod2Wiki=_postamble_ --><!-- Edit below this comment -->
 

Revision as of 13:00, 25 February 2010