html.html
来自「perl教程」· HTML 代码 · 共 333 行
HTML
333 行
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../displayToc.js"></script>
<script language="JavaScript" src="../../tocParas.js"></script>
<script language="JavaScript" src="../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../scineplex.css">
<title>Pod::Html - module to convert pod files to HTML</title>
<link rel="stylesheet" href="../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>
<body>
<script>writelinks('__top__',2);</script>
<h1><a>Pod::Html - module to convert pod files to HTML</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#synopsis">SYNOPSIS</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#functions">FUNCTIONS</a></li>
<ul>
<li><a href="#pod2html">pod2html</a></li>
<li><a href="#htmlify">htmlify</a></li>
<li><a href="#anchorify">anchorify</a></li>
</ul>
<li><a href="#environment">ENVIRONMENT</a></li>
<li><a href="#author">AUTHOR</a></li>
<li><a href="#see_also">SEE ALSO</a></li>
<li><a href="#copyright">COPYRIGHT</a></li>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Pod::Html - module to convert pod files to HTML</p>
<p>
</p>
<hr />
<h1><a name="synopsis">SYNOPSIS</a></h1>
<pre>
<span class="keyword">use</span> <span class="variable">Pod::Html</span><span class="operator">;</span>
<span class="variable">pod2html</span><span class="operator">(</span><span class="operator">[</span><span class="variable">options</span><span class="operator">]</span><span class="operator">);</span>
</pre>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>Converts files from pod format (see <a href="../../lib/Pod/perlpod.html">the perlpod manpage</a>) to HTML format. It
can automatically generate indexes and cross-references, and it keeps
a cache of things it knows how to cross-reference.</p>
<p>
</p>
<hr />
<h1><a name="functions">FUNCTIONS</a></h1>
<p>
</p>
<h2><a name="pod2html">pod2html</a></h2>
<pre>
<span class="variable">pod2html</span><span class="operator">(</span><span class="string">"pod2html"</span><span class="operator">,</span>
<span class="string">"--podpath=lib:ext:pod:vms"</span><span class="operator">,</span>
<span class="string">"--podroot=/usr/src/perl"</span><span class="operator">,</span>
<span class="string">"--htmlroot=/perl/nmanual"</span><span class="operator">,</span>
<span class="string">"--libpods=perlfunc:perlguts:perlvar:perlrun:perlop"</span><span class="operator">,</span>
<span class="string">"--recurse"</span><span class="operator">,</span>
<span class="string">"--infile=foo.pod"</span><span class="operator">,</span>
<span class="string">"--outfile=/perl/nmanual/foo.html"</span><span class="operator">);</span>
</pre>
<p>pod2html takes the following arguments:</p>
<dl>
<dt><strong><a name="item_backlink">backlink</a></strong>
<dd>
<pre>
--backlink="Back to Top"</pre>
</dd>
<dd>
<p>Adds "Back to Top" links in front of every <code>head1</code> heading (except for
the first). By default, no backlinks are generated.</p>
</dd>
<dt><strong><a name="item_cachedir">cachedir</a></strong>
<dd>
<pre>
--cachedir=name</pre>
</dd>
<dd>
<p>Creates the item and directory caches in the given directory.</p>
</dd>
<dt><strong><a name="item_css">css</a></strong>
<dd>
<pre>
--css=stylesheet</pre>
</dd>
<dd>
<p>Specify the URL of a cascading style sheet. Also disables all HTML/CSS
<code>style</code> attributes that are output by default (to avoid conflicts).</p>
</dd>
<dt><strong><a name="item_flush">flush</a></strong>
<dd>
<pre>
--flush</pre>
</dd>
<dd>
<p>Flushes the item and directory caches.</p>
</dd>
<dt><strong><a name="item_header">header</a></strong>
<dd>
<pre>
--header
--noheader</pre>
</dd>
<dd>
<p>Creates header and footer blocks containing the text of the <a href="../../lib/Pod/perlfunc.html#item_name"><code>NAME</code></a>
section. By default, no headers are generated.</p>
</dd>
<dt><strong><a name="item_help">help</a></strong>
<dd>
<pre>
--help</pre>
</dd>
<dd>
<p>Displays the usage message.</p>
</dd>
<dt><strong><a name="item_hiddendirs">hiddendirs</a></strong>
<dd>
<pre>
--hiddendirs
--nohiddendirs</pre>
</dd>
<dd>
<p>Include hidden directories in the search for POD's in podpath if recurse
is set.
The default is not to traverse any directory whose name begins with <code>.</code>.
See <a href="#item_podpath">podpath</a> and <a href="#item_recurse">recurse</a>.</p>
</dd>
<dd>
<p>[This option is for backward compatibility only.
It's hard to imagine that one would usefully create a module with a
name component beginning with <code>.</code>.]</p>
</dd>
<dt><strong><a name="item_htmldir">htmldir</a></strong>
<dd>
<pre>
--htmldir=name</pre>
</dd>
<dd>
<p>Sets the directory in which the resulting HTML file is placed. This
is used to generate relative links to other files. Not passing this
causes all links to be absolute, since this is the value that tells
Pod::Html the root of the documentation tree.</p>
</dd>
<dt><strong><a name="item_htmlroot">htmlroot</a></strong>
<dd>
<pre>
--htmlroot=name</pre>
</dd>
<dd>
<p>Sets the base URL for the HTML files. When cross-references are made,
the HTML root is prepended to the URL.</p>
</dd>
<dt><strong><a name="item_index">index</a></strong>
<dd>
<pre>
--index
--noindex</pre>
</dd>
<dd>
<p>Generate an index at the top of the HTML file. This is the default
behaviour.</p>
</dd>
<dt><strong><a name="item_infile">infile</a></strong>
<dd>
<pre>
--infile=name</pre>
</dd>
<dd>
<p>Specify the pod file to convert. Input is taken from STDIN if no
infile is specified.</p>
</dd>
<dt><strong><a name="item_libpods">libpods</a></strong>
<dd>
<pre>
--libpods=name:...:name</pre>
</dd>
<dd>
<p>List of page names (eg, "perlfunc") which contain linkable <code>=item</code>s.</p>
</dd>
<dt><strong><a name="item_netscape">netscape</a></strong>
<dd>
<pre>
--netscape
--nonetscape</pre>
</dd>
<dd>
<p><strong>Deprecated</strong>, has no effect. For backwards compatibility only.</p>
</dd>
<dt><strong><a name="item_outfile">outfile</a></strong>
<dd>
<pre>
--outfile=name</pre>
</dd>
<dd>
<p>Specify the HTML file to create. Output goes to STDOUT if no outfile
is specified.</p>
</dd>
<dt><strong><a name="item_podpath">podpath</a></strong>
<dd>
<pre>
--podpath=name:...:name</pre>
</dd>
<dd>
<p>Specify which subdirectories of the podroot contain pod files whose
HTML converted forms can be linked to in cross references.</p>
</dd>
<dt><strong><a name="item_podroot">podroot</a></strong>
<dd>
<pre>
--podroot=name</pre>
</dd>
<dd>
<p>Specify the base directory for finding library pods.</p>
</dd>
<dt><strong><a name="item_quiet">quiet</a></strong>
<dd>
<pre>
--quiet
--noquiet</pre>
</dd>
<dd>
<p>Don't display <em>mostly harmless</em> warning messages. These messages
will be displayed by default. But this is not the same as <a href="#item_verbose"><code>verbose</code></a>
mode.</p>
</dd>
<dt><strong><a name="item_recurse">recurse</a></strong>
<dd>
<pre>
--recurse
--norecurse</pre>
</dd>
<dd>
<p>Recurse into subdirectories specified in podpath (default behaviour).</p>
</dd>
<dt><strong><a name="item_title">title</a></strong>
<dd>
<pre>
--title=title</pre>
</dd>
<dd>
<p>Specify the title of the resulting HTML file.</p>
</dd>
<dt><strong><a name="item_verbose">verbose</a></strong>
<dd>
<pre>
--verbose
--noverbose</pre>
</dd>
<dd>
<p>Display progress messages. By default, they won't be displayed.</p>
</dd>
</dl>
<p>
</p>
<h2><a name="htmlify">htmlify</a></h2>
<pre>
<span class="variable">htmlify</span><span class="operator">(</span><span class="variable">$heading</span><span class="operator">);</span>
</pre>
<p>Converts a pod section specification to a suitable section specification
for HTML. Note that we keep spaces and special characters except
<code>", ?</code> (Netscape problem) and the hyphen (writer's problem...).</p>
<p>
</p>
<h2><a name="anchorify">anchorify</a></h2>
<pre>
<span class="variable">anchorify</span><span class="operator">(</span><span class="variable">@heading</span><span class="operator">);</span>
</pre>
<p>Similar to <code>htmlify()</code>, but turns non-alphanumerics into underscores. Note
that <code>anchorify()</code> is not exported by default.</p>
<p>
</p>
<hr />
<h1><a name="environment">ENVIRONMENT</a></h1>
<p>Uses <code>$Config{pod2html}</code> to setup default options.</p>
<p>
</p>
<hr />
<h1><a name="author">AUTHOR</a></h1>
<p>Tom Christiansen, <<a href="mailto:tchrist@perl.com">tchrist@perl.com</a>>.</p>
<p>
</p>
<hr />
<h1><a name="see_also">SEE ALSO</a></h1>
<p><a href="../../lib/Pod/perlpod.html">the perlpod manpage</a></p>
<p>
</p>
<hr />
<h1><a name="copyright">COPYRIGHT</a></h1>
<p>This program is distributed under the Artistic License.</p>
</body>
</html>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?