view release on metacpan or  search on metacpan

README  view on Meta::CPAN

=pod

To better view this file, use:

	perldoc README

=head1 podcnv

Take POD text (Plain Old Documentation, Perl's way to write documentation)
and render it as HTML inside a wiki page.

For instance this file here could be pasted between <pod> and </pod>
tags inside a wiki and would then be displayed as HTML for any visitor.

The reason for this extensionis that multiple authors can edit one
POD file at the same time, and enjoy the advantages of Mediawiki
like revision history, diffs, undo function, collapsable table
of contents etc.

=head1 Check the Signature

First you need to check the signature on the package to verify that
it is untampered and intact. To do this you have to:

=over 2

=item *

Install the Perl module Module::Signature from http://search.cpan.org

=item *

Get my key from http://bloodgate.com/tels.asc, import it into
GnuPG with:

	gpg --import tels.asc

You may also let the C<cpansign> utility fetch it automatically
from a keyserver, if that works for you.

=item *

Extract the package to a directory, change there and then:

=item *

Type on a console:

	cpansign --verify

inside the unpacked directory. 

=back

If the last step says "good signature" or "SIGNATURE VERIFIED OK",
everything is all right.

Note that if you C<cpansign> let GnuPG download my key from a keyserver,
it might put a C<tels.asc> file in the package directory, and then afterward
complain that "tels.asc" is not in the MANIFEST:

 Not in MANIFEST: tels.asc
 ==> MISMATCHED content between MANIFEST and distribution files! <==

You can safely ignore this warning.

B<NOTE:> Please notify me immidiately if the signature
does not verify. In that case do B<NOT> install this software, your system
might get compromised!

=head1 Installation

Install the following Perl modules into your system:

	Pod-Simple
	HTML-Parser
	HTML-Tagset

You can get these modules from C<http://search.cpan.org/>.

Afterwards, you should be able to run this on any command line:

	perl -MPod-Simple\ 99

and it should report your installed Pod::Simple (like v3.04).

	Pod::Simple version 99 required--this is only version 3.04.
	BEGIN failed--compilation aborted.

If it says something about "Pod::Simple" not being found, you need to
install it first as root (see above!).

=head2 Installation on a shared host

On a shared host you typically do not have the rights to install Perl
modules. An easy way around that limitation is to place the modules