Locale::Po4a::Pod - 將 POD
資料從/轉換為 PO 檔案
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 ('file.pod', 'file.txt');
Locale::Po4a::Pod
是一個模組，用於幫助將
POD 格式(編寫 Perl
文件的首選語言)的文件翻譯成其他
[人類] 語言。
我認為這個模組非常穩定，
/usr/lib/perl5/tk/MainWindow.pod
(以及其他一些頁面，見下文)中只有一個已知的
bug：
C<" #n">
運氣不佳，在 po4a
版本中，這是透過封裝在空間上分開的。因此，在原始版本中，手冊頁包含
" #n"
而我的則包含
"" #n""
這是因為 C<foobar>
被重寫為 "foobar"
的邏輯。
我的框中有此問題的頁面的完整列表(來自
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
作為 Pod::Parser
的派生類，Locale::Po4a::Pod
支援相同的方法和介面。有關所有細節，請參見
Pod::Parser；簡而言之，使用
"Locale::Po4a::Pod->new()"
創建一個新的解析器，然後呼叫
parse_from_filehandle() 或
parse_from_file()。
new()
可以採用鍵/值對形式的選項來控制解析器的行為。所有
Pod::Parser
子級通用的可識別選項為：
- alt
- 如果設定為 true
值，則選擇使用不同標題樣式的備用輸出格式，並在左邊距中用冒號標記
=Item 條目。預設值為
false。
- code
- 如果設定為 true
值，則輸入檔案的非
POD
部分將包括在輸出中。用於檢視使用
POD
塊記錄的程式碼，並呈現
POD
並保持程式碼不變。
- indent
- 用於縮排常規文字的空格數，以及
=over
塊的預設縮排。預設為
4。
- loose
- 如果設定為 true
值，則在 =head1
標題後列印一個空行。如果設定為
false (預設值)，則在 =head1
之後不列印空行，但在
=head2
之後仍列印一個空行。這是默認設定，因為這是手冊頁的預期格式；如果您正在格式化任意文字文件，則將其設定為
true
可能會產生更令人滿意的輸出。
- quotes
- 設定用於將 C<>
文字括起來的引號。如果值是單字元，則同時用作左引號和右引號；如果是兩個字元，則第一個字元用作左引號，第二個字元用作右引號；如果是四個字元，則前兩個字元用作左引號，後兩個字元用作右引號。
也可以將其設定為特殊值
none，在這種情況下，C<>
文字兩邊不會新增引號。
- sentence
- 如果設定為真值，Locale::Po4a::Pod
將假定每個句子以兩個空格結束，並將嘗試保留該空格。如果設定為
false，則非逐欄位落中的所有連續空格都將壓縮為一個空格。默認值為
true。
- width
- 要在其右側換行文字的列。預設為
76。
Pod::Parser,
Locale::Po4a::Man(3pm),
Locale::Po4a::TransTractor(3pm),
po4a(7)
Denis Barbier <[email protected]>
Martin Quinson (mquinson#debian.org)
版權所有 © 2002 SPI, Inc.
此程式是自由軟體；您可以根據
GPL
條款重新分發和/或修改它(請參閱複製檔案)。