LOCALE::PO4A::POD.3PM

Section: User Contributed Perl Documentation (1)
Updated: 2025-05-04
Index Return to Main Contents

名稱

Locale::Po4a::Pod - 將 POD 資料從/轉換為 PO 檔案

簡介

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();

    # 從標準輸入讀取 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">

Lack of luck, in the po4a version, this was split on the space by the wrapping. As result, in the original version, the man page contains:

 " #n"

and mine contains:

 "" #n""

這是因為 C<foobar> 被重寫為 "foobar" 的邏輯。

Complete list of pages having this problem on my box (from 564 pages; note that it depends on the chosen wrapping column):

 /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()。

另請參見

Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)

作者

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

版權和許可

This program is free software; you may redistribute it and/or modify it under the terms of GPL v2.0 or later (see the COPYING file).

This document was created by using the manual pages.
Time: 17:05:10 GMT, May 04, 2025