PO4A-UPDATEPO.1P

Section: User Contributed Perl Documentation (1)
Updated: 2025-12-06
Index Return to Main Contents

名前

po4a-updatepo - ドキュメントの (PO フォーマットの) 翻訳を更新

書式

po4a-updatepo -f fmt (-m master.doc)+ (-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

書式プラグインに渡す追加オプションです。有効なオプションやその意味の詳細は、各プラグインの説明書を参照してください。例えば、AsciiDocパーサーには '-o tablecells' を、テキストパーサーには '-o tabs=split' を渡すことができます。

--no-previous

This option removes --previous from the options passed to msgmerge(1). This helps supporting old versions of gettext(3) (before v0.16).

--previous

This option adds --previous to the options passed to msgmerge(1). It requires gettext(3) 0.16 or later, and is activated by default.

--msgmerge-opt オプション

Extra options for msgmerge(1).

-h, --help

短いヘルプメッセージを表示します。

--help-format

po4a が理解できるドキュメントフォーマットの一覧を表示します。

-V, --version

スクリプトのバージョンを表示して終了します。

-v, --verbose

プログラムの冗長度を上げます。

-d, --debug

デバッグ情報を出力します。

--porefs 種別[,wrap|nowrap]

参照形式を指定します。引数 type は、いずれの参照も生成しない never かファイルを指定するのみで行番号を指定しない file かカウンタを増加させることで行番号を置き換える counter か完全な参照を含む full のいずれかを指定できます（既定値：full）。

Argument can be followed by a comma and either wrap or nowrap keyword. References are written by default on a single line. The wrap option wraps references on several lines, to mimic gettext(3) tools (xgettext(1) and msgmerge(1)). This option will become the default in a future release, because it is more sensible. The nowrap option is available so that users who want to keep the old behavior can do so.

--wrap-po no|newlines|number（既定値：76）

poファイルの行の折り返し方法を指定します。これにより、適切に折り返されているがgitの競合につながる可能性のあるファイルか、もしくは自動的に処理しやすいものの人間にとっては読みにくいファイルかのいずれかを選択できます。

歴史的に、gettext スイートは見た目上の理由で、POファイルを77列目で折り返すよう再フォーマットしてきました。このオプションは po4a の動作を指定します。数値に設定された場合、po4aはこの列の後と、内容の改行の後でpoファイルを折り返します。newlinesに設定すると、po4aはmsgidとmsgstrを内容内の改行の後でのみ分割します。noに設定すると、po4aはpoファイルでの行折り返しを一切行いません。参照コメントの折り返しは、--porefsオプションで制御されます。

Based on the value of this option, appropriate flags (--no-wrap or --width=number) will be passed to underlying gettext utilities. Unfortunately gettext doesn't provide any counterpart for --wrap-po no, so in that case --no-wrap will be passed (the same as for --wrap-po newlines).

このオプションは、msgidとmsgstrの行の折り返し方法、すなわちこれらの文字列の内容に改行を追加する方法には影響しないことに注意してください。

--msgid-bugs-address Eメール@アドレス

msgid のバグレポートを送るアドレスをセットします。デフォルトでは、生成した POT ファイルに Report-Msgid-Bugs-To フィールドはありません。

--copyright-holder 文字列

POT ヘッダの著作権者 (copyright holder) を設定します。既定値は "Free Software Foundation, Inc." です。

--package-name string

POT ヘッダのパッケージ名をセットします。デフォルト値は "PACKAGE" です。

--package-version string

POT ヘッダのパッケージバージョンをセットします。デフォルト値は "VERSION" です。

著者

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)

訳者

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

著作権とライセンス

本プログラムは自由ソフトウェアです。GPL v2.0以降の条項に基づき再頒布と変更を行えます（COPYINGファイルを参照）。

This document was created by using the manual pages.
Time: 19:02:30 GMT, December 06, 2025

PO4A-UPDATEPO.1P

名前

書式

説明

オプション

関連項目

著者

訳者

著作権とライセンス

Index