=head1 NAME

J<< en/
Pod::Html - module to convert pod files to HTML
>>
J<< ja/Pod::Html - podファイルをHTMLに変換するためのモジュール >>

=head1 SYNOPSIS

    use Pod::Html;
    pod2html([options]);

=head1 DESCRIPTION

J<< en/
Converts files from pod format (see L<perlpod>) to HTML format.  It
can automatically generate indexes and cross-references, and it keeps
a cache of things it knows how to cross-reference.
>>
J<< ja/
pod形式(L<perlpod>参照)から
HTML形式に変換する. 
目次とクロスリファレンスは自動生成され, クロスリファレンスできる項目の
キャッシュを保持します. 
>>

=head1 ARGUMENTS

J<< en/
Pod::Html takes the following arguments:
>>
J<< ja/
Pod::Htmlは次の引数をとります:
>>

=over 4

=item backlink

    --backlink="Back to Top"

J<< en/
Adds "Back to Top" links in front of every C<head1> heading (except for
the first).  By default, no backlinks are generated.
>>
J<< ja/
``Topに戻る''リンクをすべての <code>head1</code> 見出しの前に加えます(
最初のところは除きます).
デフォルトではbacklinkは生成されません.
>>

=item cachedir

    --cachedir=name

J<< en/
Creates the item and directory caches in the given directory.
>>
J<< ja/
アイテムとディレクトリのキャッシュを指定したディレクトリに作成する.
>>

=item css

    --css=stylesheet

J<< en/
Specify the URL of a cascading style sheet.  Also disables all HTML/CSS
C<style> attributes that are output by default (to avoid conflicts).
>>
J<< ja/
カスケードスタイルシートのURLを指定します. 
またデフォルトでは出力されるすべての HTML/CSS <code>style</code> 属性を
(衝突をさけるために)無効化します. 
>>

=item flush

    --flush

J<< en/
Flushes the item and directory caches.
>>
J<< ja/
アイテム・ディレクトリキャッシュをフラッシュします.
>>

=item header

    --header
    --noheader

J<< en/
Creates header and footer blocks containing the text of the C<NAME>
section.  By default, no headers are generated.
>>
J<< ja/
C<名前>セクションのテキストをヘッダ・フッタブロックとして作成します. 
デフォルトでは生成されません.
>>

=item help

    --help

J<< en/Displays the usage message. >>
J<< ja/usageメッセージを表示します. >>

=item htmldir

    --htmldir=name

J<< en/
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.
>>
J<< ja/
生成されたHTMLが置かれるディレクトリを設定します. 
これはほかのファイルの相対リンクを生成するときにも使用されます. 
これが Pod::Html にドキュメントツリーのルートを教えるものになるので, 
これを指定しないと, すべてのリンクは絶対位置となります. 
>>

=item htmlroot

    --htmlroot=name

J<< en/
Sets the base URL for the HTML files.  When cross-references are made,
the HTML root is prepended to the URL.
>>
J<< ja/
HTMLの基準URL(base URL)を設定します. 
クロスリファレンスを作成するときにはURLにprepended(?)されます.
>>

=item index

    --index
    --noindex

J<< en/
Generate an index at the top of the HTML file.  This is the default
behaviour.
>>
J<< ja/
HTMLファイルの最初に目次を生成します(デフォルト).
>>

=item infile

    --infile=name

J<< en/
Specify the pod file to convert.  Input is taken from STDIN if no
infile is specified.
>>
J<< ja/
変換するpodファイルを指定します. 
指定がなければSTDINが使用されます.
>>

=item libpods

    --libpods=name:...:name

J<< en/
List of page names (eg, "perlfunc") which contain linkable C<=item>s.
>>
J<< ja/
リンクすることができる <code>=item</code> を含むページ名のリスト
(たとえば``perlfunc'').
>>

=item netscape

    --netscape
    --nonetscape

J<< en/
B<Deprecated>, has no effect. For backwards compatibility only.
>>
J<< ja/
<strong>廃止されています</strong>, なんの影響もでません.
後位互換のためにのみ残されています. 
>>

=item outfile

    --outfile=name

J<< en/
Specify the HTML file to create.  Output goes to STDOUT if no outfile
is specified.
>>
J<< ja/
作成するHTMLファイルを指定します. 
指定がなければSTDOUTに出力されます. 
>>

=item podpath

    --podpath=name:...:name

J<< en/
Specify which subdirectories of the podroot contain pod files whose
HTML converted forms can be linked to in cross references.
>>
J<< ja/
クロスリファレンスでリンクされるコトができる変換されたHTML形式になっているpodファイルを含んでいるpodrootのサブディレクトリを指定します.
>>

=item podroot

    --podroot=name

J<< en/
Specify the base directory for finding library pods.
>>
J<< ja/
ライブラリのpodを探す基準ディレクトリ(base directory)を指定します.
>>

=item quiet

    --quiet
    --noquiet

J<< en/
Don't display I<mostly harmless> warning messages.  These messages
will be displayed by default.  But this is not the same as C<verbose>
mode.
>>
J<< ja/
I<たいていは意味のない>警告メッセージの表示を抑制します. 
それらのメッセージはデフォルトでは表示されますが, 
C<verbose> モードで表示されるものと同じではありません. 
>>

=item recurse

    --recurse
    --norecurse

J<< en/ 
Recurse into subdirectories specified in podpath (default behaviour).
>>
J<< ja/
指定した podpath のサブディレクトリを再起的に処理する(デフォルトの振る舞い)
>>

=item title

    --title=title

J<< en/
Specify the title of the resulting HTML file.
>>
J<< ja/
生成するHTMLの最初ファイルのタイトルの指定.
>>

=item verbose

    --verbose
    --noverbose

J<< en/
Display progress messages.  By default, they won't be displayed.
>>
J<< ja/
状況メッセージを表示する. デフォルトでは表示されません. 
>>

=back

=head1 EXAMPLE

    pod2html("pod2html",
	     "--podpath=lib:ext:pod:vms",
	     "--podroot=/usr/src/perl",
	     "--htmlroot=/perl/nmanual",
	     "--libpods=perlfunc:perlguts:perlvar:perlrun:perlop",
	     "--recurse",
	     "--infile=foo.pod",
	     "--outfile=/perl/nmanual/foo.html");

=head1 ENVIRONMENT

J<< en/
Uses C<$Config{pod2html}> to setup default options.
>>
J<< ja/
デフォルトのオプションとして C<$Config{pod2html}> が使われます.
>>

=head1 AUTHOR

Tom Christiansen, E<lt>tchrist@perl.comE<gt>.

=head1 SEE ALSO

L<perlpod>

=head1 COPYRIGHT

J<< en/
This program is distributed under the Artistic License.
>>
J<< ja/
このプログラムは Artistic License の元で配布されています.
>>

=head1 TRANSALTE TO JAPANESE
J<< ja;和訳 >>

 山科 氷魚 (YAMASHINA Hio) <hio@hio.jp>

Original distribution is perl VERSION 5.8.0.
Translated on 2003-05-18.
J<< ja;
原典: perl VERSION 5.8.0.
翻訳日: 2003-05-18.
>>

=cut