.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Locale::Po4a::Pod 3pm"
.TH Locale::Po4a::Pod 3pm "2023-01-03" "Po4a 工具" "Po4a 工具"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "名稱"
.IX Header "名稱"
Locale::Po4a::Pod \- 將 \s-1POD\s0 資料從/轉換為 \s-1PO\s0 檔案
.SH "簡介"
.IX Header "簡介"
.Vb 2
\&    use Locale::Po4a::Pod;
\&    my $parser = Locale::Po4a::Pod\->new (sentence => 0, width => 78);
\&
\&    # 從標準輸入讀取 POD 並寫入標準輸出。
\&    $parser\->parse_from_filehandle;
\&
\&    # 從 file.pod 讀取 POD 並寫入 file.txt。
\&    $parser\->parse_from_file (\*(Aqfile.pod\*(Aq, \*(Aqfile.txt\*(Aq);
.Ve
.SH "描述"
.IX Header "描述"
Locale::Po4a::Pod 是一個模組，用於幫助將 \s-1POD\s0 格式(編寫 Perl 文件的首選語言)的文件翻譯成其他 [人類] 語言。
.SH "此模組的狀態"
.IX Header "此模組的狀態"
我認為這個模組非常穩定，\fI/usr/lib/perl5/tk/MainWindow.pod\fR (以及其他一些頁面，見下文)中只有一個已知的 bug：
.PP
.Vb 1
\&  C<" #n">
.Ve
.PP
運氣不佳，在 po4a 版本中，這是透過封裝在空間上分開的。因此，在原始版本中，手冊頁包含
.PP
.Vb 1
\& " #n"
.Ve
.PP
而我的則包含
.PP
.Vb 1
\& "" #n""
.Ve
.PP
這是因為 C<foobar> 被重寫為 \*(L"foobar\*(R" 的邏輯。
.PP
我的框中有此問題的頁面的完整列表(來自 564 頁；請注意，這取決於所選的換行列)：/usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod
.SH "內件"
.IX Header "內件"
作為 Pod::Parser 的派生類，Locale::Po4a::Pod 支援相同的方法和介面。有關所有細節，請參見 Pod::Parser；簡而言之，使用 \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR 創建一個新的解析器，然後呼叫 \fBparse_from_filehandle()\fR 或 \fBparse_from_file()\fR。
.PP
\&\fBnew()\fR 可以採用鍵/值對形式的選項來控制解析器的行為。所有 Pod::Parser 子級通用的可識別選項為：
.IP "\fBalt\fR" 4
.IX Item "alt"
如果設定為 true 值，則選擇使用不同標題樣式的備用輸出格式，並在左邊距中用冒號標記 \fB=Item\fR 條目。預設值為 false。
.IP "\fBcode\fR" 4
.IX Item "code"
如果設定為 true 值，則輸入檔案的非 \s-1POD\s0 部分將包括在輸出中。用於檢視使用 \s-1POD\s0 塊記錄的程式碼，並呈現 \s-1POD\s0 並保持程式碼不變。
.IP "\fBindent\fR" 4
.IX Item "indent"
用於縮排常規文字的空格數，以及 \fB=over\fR 塊的預設縮排。預設為 4。
.IP "\fBloose\fR" 4
.IX Item "loose"
如果設定為 true 值，則在 \fB=head1\fR 標題後列印一個空行。如果設定為 false (預設值)，則在 \fB=head1\fR 之後不列印空行，但在 \fB=head2\fR 之後仍列印一個空行。這是默認設定，因為這是手冊頁的預期格式；如果您正在格式化任意文字文件，則將其設定為 true 可能會產生更令人滿意的輸出。
.IP "\fBquotes\fR" 4
.IX Item "quotes"
設定用於將 C<> 文字括起來的引號。如果值是單字元，則同時用作左引號和右引號；如果是兩個字元，則第一個字元用作左引號，第二個字元用作右引號；如果是四個字元，則前兩個字元用作左引號，後兩個字元用作右引號。
.Sp
也可以將其設定為特殊值 \fBnone\fR，在這種情況下，C<> 文字兩邊不會新增引號。
.IP "\fBsentence\fR" 4
.IX Item "sentence"
如果設定為真值，Locale::Po4a::Pod 將假定每個句子以兩個空格結束，並將嘗試保留該空格。如果設定為 false，則非逐欄位落中的所有連續空格都將壓縮為一個空格。默認值為 true。
.IP "\fBwidth\fR" 4
.IX Item "width"
要在其右側換行文字的列。預設為 76。
.SH "參見"
.IX Header "參見"
Pod::Parser, \fBLocale::Po4a::Man\fR\|(3pm), \fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7)
.SH "作者"
.IX Header "作者"
.Vb 2
\& Denis Barbier <barbier@linuxfr.org>
\& Martin Quinson (mquinson#debian.org)
.Ve
.SH "版權和許可"
.IX Header "版權和許可"
版權所有 © 2002 \s-1SPI,\s0 Inc.
.PP
此程式是自由軟體；您可以根據 \s-1GPL\s0 條款重新分發和/或修改它(請參閱複製檔案)。