
        *****************************************************
        *           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::TeX - convert TeX documents and derivatives from/to PO files

=head1 説明

po4a (PO for anything) プロジェクトは、gettext ツールが想定していないドキュメントのような領域で翻訳をしやすくすること (またより興味深いのは、翻訳文の保守がしやすくなること) を目標にしています。

Locale::Po4a::TeX は、TeX ドキュメントをほかの [自然] 言語へ翻訳するのを助けるモジュールです。TeX を元にしたドキュメント用モジュールを作成するベースにもなります。

Users should probably use the LaTeX module, which inherits from the TeX module and contains the definitions of common LaTeX commands.

=head1 PO4A::TEX での翻訳

このモジュールは、一般的な TeX ドキュメントを直接扱えます。ドキュメントを小さなブロック (段落、verbatim ブロック、タイトルやインデックスのような同等の小さな部位) に分割します。

There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own derivative module from this, to describe your format's details.  See the section B<WRITING DERIVATIVE MODULES> below, for the process description.

This module can also be customized by lines starting with "% po4a:" in the TeX file. This process is described in the B<INLINE CUSTOMIZATION> section.

=head1 このモジュールで使用できるオプション

以下は、このモジュール固有のオプションです:

=over 4

=item B<debug>

このモジュールの内部メカニズムのデバッグ機能を有効にします。どの部分でデバッグできるか確認するには、ソースを利用してください。

=item B<no_wrap>

改行を行うべきでない環境のコンマ区切りリストです。

verbatim 環境と no_wrap 環境には違いがあることに注意してください。verbatim ブロックを解析する、コマンドやコメントはありません。

この環境がすでに登録されていない場合、po4a は、この環境がパラメータを何も取らないとみなすでしょう。

=item B<exclude_include>

\input や \include で取り込むべきでないファイルのコロン区切りリストです。

=item B<definitions>

B<インラインカスタマイズ> 節で定義されるような、po4a 用の定義を含むファイル名です。翻訳されるドキュメントに定義を置けない場合、このオプションを利用できます。

=item B<verbatim>

verbatim として扱うべき環境のコンマ区切りリストです。

この環境がすでに登録されていない場合、po4a は、この環境がパラメータを何も取らないとみなすでしょう。

=back

Use these options to override the default behavior of the defined commands.

=head1 インラインカスタマイズ

TeX モジュールは、B<% po4a:> で始まる行によりカスタマイズできます。この行はパーサにコマンドとして解釈されます。以下のコマンドを認識します:

=over 4

=item B<% po4a: command> I<コマンド1> B<alias> I<コマンド2>

I<コマンド1> コマンドの引数が、I<コマンド2> コマンドの引数であるかのように扱うことを示します。

=item B<% po4a: command> I<コマンド1> I<パラメータ>

This describes in detail the parameters of the I<command1> command.  This information will be used to check the number of arguments and their types.

I<コマンド1> コマンドの前に置けます。

=over 4

=item アスタリスク (B<*>)

po4a は (段落の先頭や末尾にある場合) 段落からこのコマンドを抽出します。ですから、翻訳者は、翻訳可能であるとマークされたパラメータを翻訳するべきです。

=item プラス (B<+>)

As for an asterisk, the command will be extracted if it appear at an extremity of a block, but the parameters won't be translated separately. The translator will have to translate the command concatenated to all its parameters.  This keeps more context, and is useful for commands with small words in parameter, which can have multiple meanings (and translations).

注意: この場合、翻訳可能なパラメータを指定する必要はありませんが、po4a がパラメータの型と数を知らねばなりません。

=item マイナス (B<->)

この場合、コマンドは、いずれのブロックからも抽出しません。しかし、ブロック内に一つしかないときだけ、翻訳可能とマークしたパラメータを翻訳者に提示します。これは font コマンドに対して便利です。こういったコマンドは、(文脈を保持するため) 一般的に段落から切り離すべきではありませんが、文字列全体がそういったコマンドになっている場合は、切り離さずにいて、翻訳者をいらつかせる理由はありません。

=back

I<parameters> 引数は、[] (任意オプション) のセットか、
{} (必須オプション) のセットです。
括弧の間にアンダースコア (_) を配置し、パラメータを訳さなければならない
ことを指定できます。以下のようになります:
 % po4a: command *chapter [_]{_}

これは、chapter コマンドには二つのパラメータがあり、両方とも翻訳の必要が
あることを示します: オプション (短いタイトル) と必須のもの。
href コマンドには二つの必須パラメータがあり、URL (第 1 パラメータ) を
訳したくなく、さらに、(文の中で翻訳者がリンクを移動できるように)
このコマンドを段落から分離したくない場合、以下のようになります:
 % po4a: command -href {}{_}

この場合、翻訳するべき引数を示す情報は、この href コマンドだけからなる段落の場合にのみ使用されます。

=item B<% po4a: environment> I<env> I<parameters>

This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.
This information is later used to check the number of arguments of the
\begin command.
The syntax of the I<parameters> argument is the same as described for the
others commands.
The first parameter of the \begin command is the name of the environment.
This parameter must not be specified in the list of parameters. Here are
some examples:
 % po4a: environment multicols {}
 % po4a: environment equation

command と同様に、I<env> の前にプラス (+) を付けると、その \begin コマンドはすべての引数と一緒に翻訳されることを表します。

=item B<% po4a: separator> I<env> B<">I<regex>B<">

与えた正規表現により環境が分割されることを示します。

The regular expression is delimited by quotes.  It should not create any back-reference.  You should use (?:) if you need a group.  It may also need some escapes.

例えば、LaTeX モジュールは "(?:&|\\\\)" という正規表現を、表の各セル (行を '\\' で区切り、セルを '&' で区切る) を別個に翻訳するために使用します。

The notion of environment is expanded to the type displayed in the PO file. This can be used to split on "\\\\" in the first mandatory argument of the title command.  In this case, the environment is title{#1}.

=item B<% po4a: verbatim environment> I<env>

I<env> が verbatim 環境であることを示します。この環境では、コメントとコマンドは無視されます。

この環境がすでに登録されていない場合、po4a は、この環境がパラメータを何も取らないとみなすでしょう。

=back

=head1 派生モジュールの作成

=over 4

=item B<pre_trans>

=item B<post_trans>

=item B<add_comment>

Add a string as a comment to be added around the next translated element. This is mostly useful to the texinfo module, as comments are automatically handled in TeX.

=item B<translate>

Transtractor の translate 関数のラッパーで、前処理や後処理のフィルタになります。

段落のコメントを、その段落の最初の翻訳文字列の PO コメントに挿入します。

=item B<get_leading_command>($buffer)

この関数は以下のものを返します:

=over 4

=item コマンド名

与えられたバッファの先頭にコマンドが見つからない場合、この文字列は空になります。分割できるコマンドのみであることが考えられます。%separated_command ハッシュには、これらのコマンドのリストが含まれています。

=item 派生

派生が使われるかを示します。例えば、番号付けされるべきではないことを指定するのに、アスタリスク (*) を section コマンドの最後に追加できます。この場合、フィールドは "*" を含むでしょう。派生がなければ、このフィールドは空文字列となります。

=item タプル (引数の型と引数) の配列

引数の型は '{' (必須引数) や '[' (オプション引数) のどちらでも可能です。

=item 残りのバッファ

先頭からコマンドやその引数を取り去った後の、バッファの残りです。コマンドがなければ、元のバッファに手をつけず、このフィールドに返ります。

=back

=item B<get_trailing_command>($buffer)

B<get_leading_command> と同じですが、バッファの後ろからコマンドを取ります。

=item B<translate_buffer>

前後に付けられた (分割して翻訳すべき) コマンドで区切られたバッファを、再帰的に翻訳します。

現在の環境の %translate_buffer_env で関数が定義されると、translate_buffer() に代えてこの関数がバッファの翻訳に使用されます。

=item B<read>

Overloads Transtractor's read().

=item B<read_file>

再帰的にファイルを読み込み、@exclude_include 配列にリストされていない取り込みファイルを追加します。取り込みファイルを、B<kpsewhich> コマンドを使用して、Kpathsea ライブラリから探します。

ファイル取り込み部を除いて、Transtractor の read からカット & ペーストしたものです。

=back



=over 4

=item B<parse_definition_file>

po4a ディレクティブがあるファイルのパース用サブルーチンです (新しいコマンドを定義します)。

=item B<parse_definition_line>

"% po4a: " の形の定義行をパースします。

詳細は、B<インラインカスタマイズ> 節を参照してください。

=item B<is_closed>

=item B<parse>

=item B<docheader>

=back

=head1 INTERNAL FUNCTIONS used to write derivative parsers

コマンド関数と環境関数は、($self オブジェクトに加えて) 以下の引数を取ります:

=over 

=item コマンド名

=item 派生

=item (型、引数の) タプルの配列

=item 現在の環境

=back

先頭の 3 つの引数は get_leading_command や get_trailing_command で抽出されます。

コマンド関数や環境関数は、引数や新しい環境でのコマンドの翻訳を返します。

環境関数は \begin コマンドが見つかると呼ばれます。これらは \begin コマンドとその引数により呼ばれます。

TeX モジュールは一つのコマンド関数と一つの環境関数しか提案しません。generic_command と generic_environment です。

generic_command は、register_generic_command や
TeX ファイルへの追加定義で指定した情報を使用します:
 % po4a: command I<command1> I<parameters>

generic_environment は、register_generic_environment や
TeX ファイルへの追加定義で指定した情報を使用します:
 % po4a: environment I<env> I<parameters>

どちらの関数も、翻訳可能であると ('_' で) 指定したパラメータのみを翻訳します。generic_environment は環境スタックに環境名を追加し、generic_command は、({#7} や [#2] のような) パラメータの識別子が続くコマンド名を追加します。

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

このモジュールはもっとテストが必要です。

本と Python ドキュメントでテストされました。

=head1 TODO リスト

=over 4

=item 新しいコマンドの自動検出

TeX モジュールは、newcommand の引数をパースし、引数の数や型、翻訳するべきか否かを推測できるはずです。

=item 環境セパレータの翻訳

\item が環境セパレータとして使われている場合、item の引数は続く文字列にアタッチされます。

=item いくつかのコマンドを環境スタックに追加するべき

これらのコマンドは組で指定するべきです。verbatim 環境の開始または終了のコマンドを指定できます。

=item その他

ソースの様々なほかの場所に TODO タグが付いています。

=back

=head1 既知のバグ

ソースの様々な場所に FIXME タグが付いています。

=head1 関連項目

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

=head1 著者

 Nicolas François <nicolas.francois@centraliens.net>


=head1 訳者

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

=head1 著作権とライセンス

Copyright © 2004, 2005 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.

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

