
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 名前

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

=head1 書式

    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');

=head1 説明

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

=head1 このモジュールの状態

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

  C<" #n">

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

 " #n"

私のところでは以下を含みます

 "" #n""

このロジックにより CE<lt>foobarE<gt> が "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





=head1 内部構造

Pod::Parser の派生クラスと同様に、Locale::Po4a::Pod は同じメソッドとインターフェースをサポートしています。すべての詳細は L<Pod::Parser> を参照してください。簡単に言うと、C<< Locale::Po4a::Pod->new() >> で新しいパーサを作成し、parse_from_filehandle() と parse_from_file() のどちらかを呼び出します。

new() はキーと値の組の形のオプションを取り、パーサの振る舞いを制御できます。認識する以下のオプションは、Pod::Parser のすべての派生クラスで共通です:

=over 4

=item B<alt>

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

=item B<code>

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

=item B<indent>

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

=item B<loose>

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

=item B<quotes>

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

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

=item B<sentence>

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

=item B<width>

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

=back

=head1 関連項目

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 著者

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


=head1 訳者

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

=head1 著作権とライセンス

Copyright © 2002 SPI, Inc.

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

