Provided by: po4a_0.45-1_all
名前
Locale::Po4a::AsciiDoc - PO ファイルと AsciiDoc ドキュメントの変換
説明
po4a (PO for anything) プロジェクトは、gettext ツールが想定していないドキュメントのような 領域で翻訳をしやすくすること (またより興味深いのは、翻訳文の保守がしやすくなること) を目標 にしています。 Locale::Po4a::AsciiDoc は、AsciiDoc フォーマットのドキュメントを翻訳するのを助けるモジュー ルです。
このモジュールで使用できるオプション
以下は、このモジュール固有のオプションです。 definitions インラインカスタマイズ セクションで定義されるような、po4a 用の定義を含むファイル名で す。翻訳されるドキュメントに定義を置けない場合、このオプションを利用できます。 定義ファイルでは、行を 2 つのスラッシュではなく、直接 po4a: で開始しなくてはなりませ ん。 entry 翻訳したい属性エントリの、空白区切りリストです。デフォルトでは、翻訳する属性エントリは ありません。 macro マクロ定義の、空白区切りリストです。 style スタイル定義の、空白区切りリストです。
インラインカスタマイズ
AsciiDoc モジュールは、% po4a: で始まる行によりカスタマイズできます。この行はパーサにコマ ンドとして解釈されます。以下のコマンドを認識します。 //po4a: macro name[attribute list] macro パラメータの詳細を記述できます。name は妥当なマクロ名でなければならず、ターゲッ トを訳さなければならない場合、アンダースコアで終わらなければなりません。 attribute list 引数は、翻訳できる引数のコンマ区切りリストです。このリストには、位置パ ラメータを定義する数値か、属性名のどちらでも指定できます。 name の前にプラス記号 (+) をつけると、マクロとその引数全体が翻訳対象になります。この場 合、属性リストの定義は不要ですが、角カッコは必要です。 //po4a: style [attribute list] 翻訳すべきスタイルの属性を記述できます。 attribute list 引数は、翻訳できる引数のコンマ区切りリストです。このリストには、位置パ ラメータを定義する数値か、属性名のどちらでも指定できます。先頭の属性はスタイル名で、翻 訳対象になりません。 スタイル名の前にプラス記号 (+) をつけると、属性リスト全体が翻訳対象になります。翻訳す る属性の定義は不要です。 スタイル名の前にマイナス記号 (-) をつけると、この属性は翻訳対象外です。 //po4a: entry name 翻訳する属性エントリを定義します。デフォルトでは翻訳しません。
このモジュールの状態
シンプルな AsciiDoc ファイルでのテストが成功しています。
著者
Nicolas François <nicolas.francois@centraliens.net> Denis Barbier <barbier@linuxfr.org>
訳者
倉澤 望 <nabetaro@debian.or.jp> Debian JP Documentation ML <debian-doc@debian.or.jp>
著作権・ライセンス
Copyright 2005-2008 by Nicolas FRANÇOIS <nicolas.francois@centraliens.net>. Copyright 2012 by Denis BARBIER <barbier@linuxfr.org>. 本プログラムはフリーソフトウェアです。GPL の条項に基づき再頒布と変更を行うことができます (COPYING ファイルをご覧ください)。