書式
po4a-updatepo -f fmt (-m master.docE)+ (-p XX.po)+(XX.po は出力ファイル。その他すべては入力ファイル)
説明
po4a (PO for anything) プロジェクトは、gettext ツールが想定していないドキュメントのような領域で翻訳をしやすくすること (またより興味深いのは、翻訳文の保守がしやすくなること) を目標にしています。po4a-updatepo スクリプトは、オリジナルドキュメントのファイルに行われた変更を反映し、PO ファイルの更新を担当します。これには、ドキュメントファイルを POT ファイルに変換し、msgmerge(1) を呼び出して、この新しい POT ファイルを PO ファイルに適用します。
(複数の言語を一度に更新する場合) 複数の PO ファイルと、(複数のドキュメントの翻訳を同じ PO ファイルに格納したい場合) 複数の文書ファイルを指定できます。
マスタードキュメントが非 ASCII 文字の場合、文化に依存せず非標準文字を許容できるように、PO ファイルを UTF-8 に変換します (まだ変換していない場合)。
オプション
- -f, --format
- 扱うドキュメントのフォーマットです。有効なフォーマットの一覧を見るには、--help-format オプションを使用してください。
- -m, --master
- 翻訳するマスタードキュメントを含むファイルです。
- -M, --master-charset
- 翻訳するドキュメントを含むファイルの文字セットです。すべてのファイルが、同じ文字セットを使用していなければならないことに注意してください。
- -p, --po
- 更新する PO ファイルです。ファイルが存在しない場合、po4a-updatepo が作成します。
- -o, --option
- フォーマットプラグインやその他のpo4a内部モジュールに渡す追加オプションです。各オプションは、'name=value' のフォーマットで指定してください。有効なオプションやその意味の詳細は、各プラグインのドキュメントをご覧ください。
- --no-previous
- このオプションは、msgmerge に渡すオプションから --previous を削除します。 これにより 0.16 より前の gettext をサポートできます。
- --previous
- このオプションは、msgmerge に渡すオプションに --previous を追加します。gettext 0.16 以降が必要で、デフォルトで有効です。
- --msgmerge-opt options
- Extra options for msgmerge(1).
- -h, --help
- 短いヘルプメッセージを表示します。
- --help-format
- po4a が理解できるドキュメントフォーマットの一覧を表示します。
- -V, --version
- スクリプトのバージョンを表示し、終了します。
- -v, --verbose
- プログラムの冗長度を上げます。
- -d, --debug
- デバッグ情報を出力します。
- --porefs type[,wrap|nowrap]
-
リファレンスフォーマットを指定します。引数 type には、いずれのリファレンスも提供しない none、行番号を明示しない
noline (正確に言うと行番号は 1 に置換されます)、行番号をカウントアップする counter、完全なリファレンスを含む
full のどれか一つを指定できます。
引数にはコンマで続けて、wrap か nowrap というキーワードを後に付けられます。デフォルトでは、リファレンスを 1 行で書き出します。wrap オプションは、gettext ツール (xgettext や msgmerge) のように、リファレンスを複数行に折り返します。このオプションは、より気が利いているため、将来のリリースでデフォルトとなります。元の挙動のままにしておきたいユーザは、nowrap オプションを使用できます。
- --msgid-bugs-address email@address
- msgid のバグレポートを送るアドレスをセットします。デフォルトでは、生成した POT ファイルに Report-Msgid-Bugs-To フィールドはありません。
- --copyright-holder string
- POT ヘッダの著作権者 (copyright holder) をセットします。デフォルト値は ``Free Software Foundation, Inc.'' です。
- --package-name string
- POT ヘッダのパッケージ名をセットします。デフォルト値は ``PACKAGE'' です。
- --package-version string
- POT ヘッダのパッケージバージョンをセットします。デフォルト値は ``VERSION'' です。
著者
Denis Barbier <[email protected]> Nicolas François <[email protected]> Martin Quinson (mquinson#debian.org)
訳者
倉澤 望 <[email protected]> Debian JP Documentation ML <[email protected]>
著作権・ライセンス
Copyright 2002-2012 by SPI, inc.本プログラムはフリーソフトウェアです。GPL の条項に基づき再頒布と変更を行うことができます (COPYING ファイルをご覧ください)。