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 towiki
. 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
Copyright
(c) MMIII-MMX1V John McNamara.
All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.