table of contents
POD2WIKI(1p) | User Contributed Perl Documentation | POD2WIKI(1p) |
NAME¶
pod2wiki - 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
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.
2022-10-13 | perl v5.34.0 |