Ubuntu Manpage: Locale::Po4a::Pod - PO ファイルと POD データの変換

名前

       Locale::Po4a::Pod - PO ファイルと POD データの変換

書式

           use Locale::Po4a::Pod;
           my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

           # Read POD from STDIN and write to STDOUT.
           $parser->parse_from_filehandle;

           # Read POD from file.pod and write to file.txt.
           $parser->parse_from_file ('file.pod', 'file.txt');

説明

       Locale::Po4a::Pod は、POD フォーマット (Perl のドキュメント用に用意された言語) のドキュメントをほかの [自
       然] 言語へ翻訳するのを助けるモジュールです。

このモジュールの状態

       このモジュールは岩のように安定していると思いますが、/usr/lib/perl5/Tk/MainWindow.pod (とその他のペー
       ジ。以下参照) には、たった一つ以下のような既知のバグがあります:

         C<" #n">

       残念ながら、po4a のバージョンでは、折り返しにより空白で分割されてしまいました。その結果、オリジナルバー
       ジョンでは、man に以下を含みます

        " #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 真の値に設定した場合、代替出力フォーマットを選択します。とりわけ、見出しに異なるスタイルを使い、左
           マージンとコロンで =item エントリをマークします。デフォルトは false です。

       code
           真の値に設定した場合、入力ファイルの非   POD  部を出力に含めます。POD  ブロックで説明されているコード
           を、コードが損なわれないままに POD をレンダリングして表示するのに便利です。

       indent
           通常のテキストをインデントする空白の数で、=over  ブロックに対するデフォルトのインデントです。デフォル
           トは 4 です。

       loose
           真の値に設定した場合、空行を =head1 見出しの後に出力します。偽の値に設定した場合 (デフォルト)、=head2
           の後には空行を出力しますが、=head1 の後に空行を出力しません。マニュアルページが期待している形式である
           ため、これをデフォルトとしています。テキストドキュメントを任意に整形する場合、真に設定すると、より満
           足する出力結果になるでしょう。

       quotes
           C<> テキストを囲むために使用される引用符を設定します。値が 1 文字の場合、左右の引用符の両方として使用
           されます。2   文字の場合、最初の文字を左引用符とし、次の文字を右引用符として使用されます。4  文字の場
           合、最初の 2 文字を左引用符とし、次の 2 文字を右引用符として使用されます。

           ここには特殊な値 none も設定できます。この場合、C<> テキストのまわりに引用符を追加しません。

       sentence
           値を true とすると、Locale::Po4a::Pod  は各文が二つの空白で終わると仮定し、その空白を保持しようとしま
           す。値を   false   とすると、非逐語段落にある連続した空白すべてを一つの空白に圧縮します。デフォルトは
           true です。

       width
           テキストを折り返す右端の文字数です。デフォルトは 76 です。

著者

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

訳者

        倉澤 望 <nabetaro@debian.or.jp>
        Debian JP Documentation ML <debian-doc@debian.or.jp>

著作権とライセンス

       Copyright © 2002 SPI, Inc.

       本プログラムはフリーソフトウェアです。GPL の条項に基づき再頒布と変更を行うことができます (COPYING  ファイ
       ルを参照してください)。

Po4a Tools                                         2022-01-02                             Locale::Po4a::Pod(3pm)

名前

書式

説明

このモジュールの状態

内部構造

関連項目

著者

訳者

著作権とライセンス