pod2wiki - Man Page

A utility to convert Pod documents to Wiki format.

Synopsis

pod2wiki [--style --noerrata --help --man] podfile [outfile]

    Options:
        --style      wiki style (defaults to wiki. See --help)
        --noerrata   don't generate a "POD ERRORS" section
        --help       brief help message
        --man        full documentation

Description

This program is used for converting Pod text to Wiki text.

Pod is Perl's Plain Old Documentation format. See man perlpod or perldoc perlpod.

A Wiki is a user extensible web site. It uses very simple mark-up that is converted to Html. For an introduction to Wikis see: <http://en.wikipedia.org/wiki/Wiki>

Options

podfile

The input file that contains the Pod file to be converted. It can also be stdin.

outfile

The converted output file in wiki format. Defaults to stdout if not specified.

--style or -s

Sets the wiki style of the output. If no style is specified the program defaults to wiki. The available options are:

wiki

This is the original Wiki format as used on Ward Cunningham's Portland repository of Patterns. See <http://c2.com/cgi/wiki>.

kwiki

This is the format as used by Brian Ingerson's Kwiki: <http://www.kwiki.org>.

usemod

This is the format used by the Usemod wikis. See: <http://www.usemod.com/cgi-bin/wiki.pl>.

twiki

This is the format used by TWiki wikis. See: <http://twiki.org/>.

tiddlywiki

This is the format used by the TiddlyWiki. See: <http://www.tiddlywiki.com/>.

textile

The Textile markup format as used on GitHub. See: <http://textile.thresholdstate.com/>.

wikipedia or mediawiki

This is the format used by Wikipedia and MediaWiki wikis. See: <http://www.mediawiki.org/>.

markdown

This is the format used by GitHub and other sites. See: <http://daringfireball.net/projects/markdown/syntax>.

moinmoin

This is the format used by MoinMoin wikis. See: <http://moinmo.in/MoinMoinWiki>.

muse

Emacs Muse (also known as "Muse" or "Emacs-Muse") is an authoring and publishing environment for Emacs.

confluence

This is the format used by Confluence. See: <http://www.atlassian.com/software/confluence/>.

--encoding

Specify the encoding for the output filehandle:

    --encoding=":utf8"

Refer to binmode in perlfunc for more details. This option is only available in Perl 5.8 and later.

--noerrata or -noe

Don't generate a "POD ERRORS" section at the end of the document. Equivalent to the Pod::Simple::no_errata_section() method.

--help or -h

Print a brief help message and exits.

--man or -m

Prints the manual page and exits.

Disclaimer of Warranty

Please refer to the DISCLAIMER OF WARRANTY in Pod::Simple::Wiki.

Author

John McNamara jmcnamara@cpan.org

Info

2024-01-25 perl v5.38.2 User Contributed Perl Documentation