名前

Locale::Po4a::AsciiDoc - PO ファイルと AsciiDoc ドキュメントの変換

説明

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

Locale::Po4a::AsciiDoc は、AsciiDoc フォーマットのドキュメントを翻訳するのを助けるモジュールです。

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

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

definitions

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

定義ファイルでは、行は二つのスラッシュではなく直接 po4a: で開始しなくてはなりません。

entry

翻訳したい属性エントリの空白区切りリストです。デフォルトでは、翻訳する属性エントリはありません。

macro

マクロ定義の空白区切りリストです。

style

スタイル定義の空白区切りリストです。

noimagetargets

By default, the targets of block images are translatable to give opportunity to make the content point to translated images. This can be stopped by setting this option.

インラインカスタマイズ

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 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
 Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
 Copyright © 2017 Martin Quinson <mquinson#debian.org>.

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