NAME

Pod::MultiLang::Html - turn MultiLang-pod into html ja;Pod::MultiLang::Html_ja - 多言語 Pod を html に変換

SYNOPSIS

$parser = Pod::MultiLang::Html->new(%opts);
$parser->parse_from_file($infile,$outfile);

DESCRIPTION

Pod::MultiLang::Html translates pod into html. This inherits Pod::MultiLang and it inherits Pod::Parser, usage is same as Pod::Parser. ja; Pod::MultiLang を継承する html へのトランスレータです. Pod::MultiLang は Pod::Parser を基底としているので, 基本的な使用方法はそれにならいます.

command/verbatim/textblock methods only do push paragraphs into an array, and end_pod method do conversion. (these process is in Pod::MultiLang.) ja; command/verbatim/textblock では配列への蓄積のみを行いっていて, 変換処理は end_pod で行っている. (command/verbatim/textblock の 処理は Pod::MultiLang が行っている.)

prepare (listing up headings, setup index words, etc.) at $parser->rebuild(), and generate at $parser->output_html(); ja; Pod::MultiLang::Html では, 生成の準備(見出しのリストアップ, 索引語の生成等)を $parser->rebuild() において行い, $parser->output_html() が生成した情報から出力のみを行う という二段になっている.

generate html is xhtml 1.1 ^^; ja; xhtml 1.1 を生成してたり^^;

OPTIONS

method new takes follow arguments: ja; new の引数は以下のものがあります.

langs

langs => [qw(ja en)]

inherited from Pod::MultiLang. pass to Pod::MultiLang->new(). see "new" in Pod::MultiLang. ja; Pod::MultiLang から引き継いでいるオプション. Pod::MultiLang->new() に渡されます. "new" in Pod::MultiLang を参照してください.

specify languages. paragraphs which exist in mlpod document but not selected with langs are ignored in result. ja; 使用する言語を指定します. 指定されなかった言語は, mlpod 中にあっても無視されます.

made

made => 'mailto:example@example.com'

embed into <link rev="made" href="" />. ja; <link rev="made" href="" /> に埋め込まれます.

css

css => 'style/podstyle.css'

<meta http-equiv="Content-Style-Type" content="text/css" />
<link rel="stylesheet" type="text/css" href="style/podstyle.css" />

relative path between specified location and location that output file is generated. ja; html には位置は出力するファイルと指定したcssファイルとの 相対位置で埋め込まれます.

poddir

poddir => [qw(html/pod html/pragma html/lib)]

directories for existence check of file linked from pod. by array reference. ja; リンク先の存在確認に使うディレクトリを指定します. 配列リファレンスを指定します.

missing_poddir

used when no link target found in poddir and link target seems perl core documents. ja; poddir にリンク先が見つからなかったときに, それが perl ドキュメントらしかったときに代わりに リンク先に使うディレクトリを指定します.

if omitted then missing_dir is used. ja; 省略時には missing_dir が使われます.

missing_pragmadir

used when no link target found in poddir and link target seems pragma documents. ja; poddir にリンク先が見つからなかったときに, それが pragma ドキュメントらしかったときに代わりに リンク先に使うディレクトリを指定します.

省略時には missing_dir が使われます.

missing_dir

used when no link target found in poddir. ja; poddir にリンク先が見つからなかったときに, 代わりにリンク先に使うディレクトリを指定します.

in_charset

encoding for input document. default is utf-8. ja; 入力ファイルのエンコーディングを指定します. デフォルトでは utf-8 です.

out_charset

encoding for output document. default is utf-8. ja; 出力ファイルのエンコーディングを指定します. デフォルトでは utf-8 です.

and embed as <meta content="Content-Type" value="text/html; charset=" /> . ja; <meta content="Content-Type" value="text/html; charset=" /> にも埋め込まれます.

default_lang

language for outsize of J<> interior sequence. ja; J<> で囲まれていない文章に対する言語を指定します.

METHODS

new

create new instance.

OVERRIDES

This module implements Pod::Parser.

begin_pod

end_pod

interior_sequence

PRIVATE FUNCTIONS

rebuild

buildtitle

buildhtml

addindex

output_html

escapeHtml

escapeUrl

makelink

makelinkanchor

plainize

resolveLink

resolvePodEscape

unescapeHtml

verbmsg

SEE ALSO

Pod::MultiLang ja; Pod::MultiLang