PO4A-TRANSLATE.1P

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

名前

po4a-translate - PO ファイルをドキュメントフォーマットへ変換

書式

po4a-translate -f fmt -m master.doc -p XX.po -l XX.doc

(XX.doc は出力ファイル。その他すべては入力ファイル)

説明

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

po4a-translate スクリプトは、(PO ファイルで行われた) 翻訳から元のドキュメントフォーマットへの変換を担当します。与える PO ファイルは、po4a-gettextize(1) で得た POT ファイルを翻訳したものであるべきです。

オプション

-f, --format: 扱うドキュメントのフォーマットです。有効なフォーマットの一覧を見るには、--help-format オプションを使用してください。
-a, --addendum: 生成するファイルに追加するファイル (例えば、翻訳者名や「この翻訳について」節) です。挿入するファイルの先頭行は、追加する位置を指定する PO4A ヘッダです (po4a(7) の 翻訳におまけのテキストを追加するには 節を参照してください)。
-A, --addendum-charset: 追加内容の文字セットです。追加内容では、すべて同じ文字セットを使用することに注意してください。
-m, --master: 翻訳するマスタードキュメントのファイルです。
-M, --master-charset: 翻訳するドキュメントファイルの文字セットです。
-l, --localized: 書き出される地域化 (翻訳済み) ドキュメントのファイルです。
-L, --localized-charset: 地域化ドキュメントファイルの文字セットです。
-p, --po: メッセージカタログとして読み込むファイルです。
-o, --option: 書式プラグインに渡す追加オプションです。有効なオプションやその意味の詳細は、各プラグインの説明書を参照してください。例えば、AsciiDocパーサーには '-o tablecells' を、テキストパーサーには '-o tabs=split' を渡すことができます。
-k, --keep: 生成するファイルを維持する（つまり書き出す）翻訳率のしきい値（既定値：80）。言い換えると、既定値では書き出されるために少なくとも 80% は翻訳されていなければならないということです。
-w, --width: 結果のファイルで折り返す列です（既定は76）。形式で対応しているときに有効です。与えられた値が0以下なら、結果のファイルは全く折り返されません。その形式で折り返し直すと壊れてしまうときに便利です。
-h, --help: 短いヘルプメッセージを表示します。
--help-format: po4a が理解できるドキュメントフォーマットの一覧を表示します。
-V, --version: スクリプトのバージョンを表示して終了します。
-v, --verbose: プログラムの冗長度を上げます。
-d, --debug: デバッグ情報を出力します。

生成されたファイルへの (翻訳以外の) 内容の追加

生成される文書に翻訳以外の内容（翻訳者名や「この翻訳について」節など）を追加するには、--addendum オプションを使用してください。

追加内容の最初の行は、ドキュメントのどこに配置するかを指定するヘッダでなければなりません (ドキュメント内の任意の部分の前後を指定できます)。ファイルの残りの部分は、さらに処理することなく、結果のファイルにそのまま追加されます。

指定したファイルに追加できないものがあった場合、po4a-translate は翻訳全体を破棄することに注意してください (見つからないファイルは作者を示すものかも知れず、翻訳のバグ報告をしたいユーザの妨げになるからです)。

ヘッダにはかなり厳密な文法があります。この機能の使い方や動作の概要は、po4a(7) man ページを参照してください。

著者

 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: 14:11:14 GMT, July 12, 2025

PO4A-TRANSLATE.1P

名前

書式

説明

オプション

生成されたファイルへの (翻訳以外の) 内容の追加

関連項目

著者

訳者

著作権とライセンス

Index