Provided by: po4a_0.73-2ubuntu1_all 
名前
po4a - PO ファイルと翻訳済みドキュメントの両方を一括更新
書式
po4a [options] config_file
説明
po4a (PO for anything) は従来のgettextツールを使った文書翻訳の保守作業を容易にします。po4aの主な特徴は内
容の翻訳を文書構造から切り離すところにあります。このプロジェクトのやさしい導入についてはページpo4a(7)を参
照してください。
実行すると po4aは設定ファイルで指定された全ての文書ファイルを解析します。（翻訳を含む）POファイルを更新し
て文書にあらゆる変更を反映し、元のマスター文書の構造に（POファイルで見付かった）内容の翻訳を注入すること
で翻訳文書を生成します。
最初、POファイルには、元の文書からの翻訳すべき文字列のみが含まれています。このファイル形式により、po4aが
抽出した各段落に対して、翻訳者が手作業で翻訳を与えることができます。翻訳後に文書が変更された場合、po4aは
対応する翻訳をPOファイル内で「fuzzy」として印を付け、翻訳者による手動のレビューを要求します。翻訳者はいわ
ゆる「補遺」を与えることもできます。これは例えば、誰が翻訳を行ったか、どのように誤りを報告するかなどを記
載した追加内容です。
マスター文書 ---+---->-------->---------+
（文書の執筆） | |
V （po4aの実行） >-----+--> 翻訳された
| | | 文書
既存のPOファイル -->--> 更新済POファイル >-+ |
^ | |
| V |
+----------<---------<-------+ ^
（手作業の翻訳過程） |
|
補遺 -->--------------------------------------+
po4aの作業工程は、オープンソースプロジェクトに相応しい非同期型です。文書の執筆者は自分のペースでマスター
文書を作成します。翻訳者はPOファイルの翻訳をレビューし、更新します。保守者は必要に応じてpo4aを再実行
し、元文書への変更をPOファイルに反映し、最新の文書構造に最新の翻訳を注入することによって、更新された文書
の翻訳を生成します。
既定では、翻訳文書はその内容の少なくとも80％が翻訳されたときに作成されます。翻訳されていないテキストは元
の言語のまま残されます。そのため翻訳が完全でない場合、作成された文書には言語が混在することになります。80%
のしきい値は、後述の --keep オプションで変更することができます。ただし、100%でないと直ちに翻訳が無視され
るのは、ほとんど利用者に見られないようになるため翻訳者の意欲をそぐかもしれませんし、一方であまりにも不完
全な「翻訳」を表示するのはエンドユーザーが困ってしまうかもしれませんので、注意してください。
翻訳された文書ファイルをバージョン管理システムに保存するのは、自動生成されるもののためおそらく悪い考えで
しょう。貴重なファイルはPOファイルであり、そこにこそ仲間の翻訳者達の苦労が詰まっているのです。ま
た、weblateなどのオンラインプラットフォームで翻訳者と交流するのが楽だという人もいますが、これは当然ながら
完全に任意です。
早分かり入門
foo という名前のプログラムを保守していて、そのプログラムには英語（ほとんどのオープンソースプロジェクトで
の橋渡しとなる言語ですが、 po4a はどの言語からでも、またどの言語へでも使えます）で書かれた man ページ
man/foo.1 があるとしましょう。いつだったか、誰かが man/foo.de.1 という名前のドイツ語の翻訳を提供したなり
立ち消えになったことがありました。ここで問題になっているのは、たった今文書にすべての言語で修正しなければ
ならないような重大な誤解を招く情報が含まれているというバグ報告を受けましたが、ドイツ語を話せないので、翻
訳ではなく元の文書を修正するしかないということです。そして今、別の貢献者がこれまた修得していない言語であ
る日本語への翻訳を提供したいと言っています。
文書の保守の悪夢を解決するために、文書をpo4aに変換する時が来ました。必要なときに文書を更新したい、仲間の
翻訳者達の作業を楽にしたい、そして、利用者が古くて誤解を招くような文書を目にすることがないようにした
い、そう思っていますよね。
変換には2つの工程が含まれます。po4aインフラの立ち上げと、以前のドイツ語翻訳を引き揚げるための変換です。こ
の後者の部分は、以下のようにpo4a-gettextizeを使用して行われます。po4a-gettextize(1) のドキュメントに詳述
されているように、この過程が完全に自動化されることは稀ですが、一度完了すればドイツ語翻訳を含む de.po ファ
イルを po4a の作業工程に統合することができます。
po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po
それではpo4aを設定しましょう。適切なファイル配置を使うと設定ファイルはこのように単純になります。
[po_directory] man/po4a/
[type: man] man/foo.1 $lang:man/translated/foo.$lang.1
これは、すべての（翻訳者の作業内容を含む）PO ファイルが man/po4a/ ディレクトリにあり、マスターファイルは
man/foo.1 の 1 つだけであることを指定するものです。もし、複数のマスターファイルがあれば、2行目のような行
がいくつもあることになります。このような行はそれぞれ、対応する翻訳ファイルをどこに書き込むかも指定しま
す。ここでは、man/foo.1 のドイツ語訳は man/translated/foo.de.1 にあります。
po4aの設定を完了するために最後に必要なものは、新しい翻訳を開始するために使用されるべきテンプレート材料を
含むPOTファイルです。指定されたpo_directoryの中にに拡張子.potの空のファイルを作成するだけです（
例：man/po4a/foo.pot）。そしてpo4aはその中に期待される内容を詰め込みます。
この立ち上げでのファイルについておさらいすると次のようになります。
├── man/
│ ├── foo.1 <- 英語で書かれた元のmanページ
│ ├── po4a/
│ │ ├── de.po <- gettextizationによるドイツ語訳のPO
│ │ └── foo.pot <- 将来の翻訳に向けたPOTテンプレート（最初は空）
│ └── translated/ <- 翻訳が作られるディレクトリ
└── po4a.cfg <-設定ファイル
一度立ち上げれば、po4aを実行すると、文書を解析し、POTテンプレートファイルを更新し、それを使ってPO翻訳ファ
イルを更新し、それを使って文書の翻訳ファイルを更新します。すべて1つのコマンドで。
po4a --verbose po4a.cfg
以上です。po4aは完璧に構成されました。man/foo.1の誤りを修正したら、ドイツ語翻訳の問題のある段落は、修正後
の英語のテキストに置き換えられるでしょう。言語が混ざることは理想的ではありませんが、自分で理解が及ばない
翻訳の誤りを取り除き、利用者に提示する内容が決して誤解を招くものにならないようにするためには、これが唯一
の方法なのです。対応するPOファイル中のドイツ語の翻訳を更新するのも遥かに簡単なので、言語の混在は長くは続
かないでしょう。最後に、新しく翻訳に貢献したい日本語の翻訳者が現れた場合は、翻訳者がfoo.potを複製し
てja.poにファイルを変更し、翻訳を完成させます。このファイルを受け取ったらman/po4a/po/の中に置くだけで
す。改めて po4a を実行すると、（充分に内容が翻訳されていれば）翻訳されたページが man/translated/foo.ja.1
として現れます。
オプション
-k, --keep
生成するファイルを維持する（つまり書き出す）翻訳率の下限値（既定値：80）。言い換えると、既定では書き
出されるために少なくとも 80％ は翻訳されディスク上に保存されていなければなりません。
-w, --width
形式が対応している場合に結果のファイルを折り返す列です（既定では76）。
-h, --help
短いヘルプメッセージを表示します。
-M, --master-charset
翻訳文書を含むファイルで使われている文字セットです。すべてのマスター文書が、同じ文字セットを使用して
いなければならないことに注意してください。
-L, --localized-charset
ローカライズされた文書を含む、ファイルで使われている文字セット。翻訳されたすべての文書は同じ文字セッ
トを使用することに注意してください。
-A, --addendum-charset
追加内容の文字セットです。追加内容では、すべて同じ文字セットを使用することに注意してください。
-V, --version
スクリプトのバージョンを表示して終了します。
-v, --verbose
プログラムの冗長度を上げます。
-q, --quiet
プログラムの冗長度を下げます。
-d, --debug
デバッグ情報を出力します。
-o, --option
書式プラグインに渡す追加オプションです。有効なオプションやその意味の詳細は、各プラグインの説明書を参
照してください。例えば、AsciiDocパーサーには '-o tablecells' を、テキストパーサーには '-o tabs=split'
を渡すことができます。
-f, --force
生成の必要はないと po4a が判断した場合でも、常に POT ファイルと PO ファイルを生成します。
デフォルトの動作 (--force を指定しない場合) は以下のようになります:
POT ファイルが存在する場合、マスター文書や設定ファイルの方が新しければ（--no-updateが指定されてい
る場合を除き）再生成を実行します。POT ファイルもまた一時文書に書き出され、変更が本当に必要かどう
か po4a が検証を行います。
また、マスタードキュメント、PO ファイル、追加内容のどれか、設定ファイルのいずれかが翻訳より新しい
場合にのみ、翻訳を再生成します。しきい値に達しない翻訳を再生成しないように (--keep を参
照)、.po4a-stamp 拡張子を持つファイルを作成します (--stamp を参照)。
マスタードキュメントがファイルをインクルードする場合、インクルードするファイルの更新時刻は考慮されな
いため、--force フラグを使用するべきです。
PO ファイルは、常に POT を元に msgmerge -U で再生成されます。
--stamp
翻訳が閾値に到達せず生成されないとき、po4a にスタンプファイルを作成するように指示します。このスタンプ
ファイルは翻訳済みドキュメントが期待する名前に .po4a-stamp 拡張子をつけた名前となります。
注意: これは .po4a-stamp ファイルの作成を行うだけです。スタンプファイルは存在すれば使用さ
れ、--rm-translations を指定した場合や、最終的にファイルの翻訳が完了した場合に削除されます。
--no-translations
翻訳済みドキュメントを生成せず、POT ファイルや PO ファイルの更新のみ行います。
--no-update
POT、POのファイルは変更せず、翻訳のみを更新することができます。
--keep-translations
翻訳が --keep で指定された閾値を満たしていない場合でも、既存の翻訳ファイルを保持します。 このオプショ
ンでは、内容の乏しい新しい翻訳ファイルは作成されませんが、マスターファイルへの変更のために陳腐化した
既存の翻訳が保存されます。
警告：このフラグは po4a の動作をかなり大幅に変更します。というのは、翻訳が改善されるまで、あなたの翻
訳したファイルはまったく更新されないからです。正確な未翻訳の文書より、古びた翻訳文書のほうを世に出し
たい場合にのみ、このフラグを使用してください。
--rm-translations
翻訳済みファイルを削除します (--no-translations を暗に意味します)。
--no-backups
このフラグは 0.41 から何もしなくなりました。また今後のリリースで削除される可能性があります。
--rm-backups
このフラグは 0.41 から何もしなくなりました。また今後のリリースで削除される可能性があります。
--translate-only 翻訳されたファイル
指定したファイルに対する翻訳のみ行います。設定ファイル内にファイルがたくさん指定されている場合、処理
の高速化に役立つことでしょう。このオプションは、PO ファイルと POT ファイルの更新を行わないことに注意
してください。このオプションは複数回指定できます。
--variable var=value
po4a 設定ファイル内で展開する変数を定義します。現れるすべての $(var) は、value に置換されます。このオ
プションは複数回使用できます。
--srcdir ソースディレクトリ
po4a 設定ファイルで指定されたすべての入力文書に対する基底ディレクトリを指定します。
l<destdir>とl<srcdir>の両方が指定された場合、入力ファイルはl<destdir>、現在のディレクト
リ、l<srcdir>の順番で探索します。出力ファイルは、指定されていればl<destdir>に、そうでなければ現在の
ディレクトリに書き出されます。
--destdir 対象ディレクトリ
po4aの設定ファイルで指定されたすべての出力文書の基底ディレクトリを設定します（前述の--srcdirを参
照）。
POTヘッダーを変更するオプション
--porefs type
参照形式を指定します。引数 type は、いずれの参照も生成しない none、ファイルを指定するのみで行番号を指
定しない noline、カウンタを増加させることで行番号を置き換える counter、完全な参照を含む full のいずれ
かを指定できます（既定値：full）。
--wrap-po no|newlines|number（既定値：76）
poファイルの行の折り返し方法を指定します。これにより、適切に折り返されているがgitの競合につながる可能
性のあるファイルか、もしくは自動的に処理しやすいものの人間にとっては読みにくいファイルかのいずれかを
選択できます。
歴史的な理由から、gettextスイートは整形を理由にpoファイルを77行目で折り返すことで再整形します。このオ
プションはpo4aの振舞いを指定するものです。数値が指定された場合、po4aはこの行中の位置以降にある内容中
の改行箇所でpoファイルを折り返します。newlinesが指定された場合、po4aは内容中の改行箇所での
みmsgidとmsgstrを分割します。noが指定された場合、po4aはpoファイルをまったく折り返しません。参照コメン
トはpo4aが内部的に用いるgettextツールによって常に折り返されます。
このオプションは、msgidとmsgstrの行の折り返し方法、すなわちこれらの文字列の内容に改行を追加する方法に
は影響しないことに注意してください。
--master-language
翻訳文書を含むソースファイルの言語。すべてのマスター文書が同じ言語を使用する必要があることに注意して
ください。
--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" です。
PO ファイルを変更するオプション
--msgmerge-opt オプション
msgmerge(1) 用の追加オプションです。
注意: $lang は現在の言語へ展開されます。
--no-previous
このオプションは、msgmerge に渡すオプションから --previous を削除します。これは0.16より前のgettextの
サポートに不可欠なものです。
--previous
このオプションは、msgmerge に渡すオプションに --previous を追加します。gettext 0.16 以降が必要で、デ
フォルトで有効です。
設定ファイル
po4a は引数として設定ファイルを必要とします。このファイルには、次の要素が含まれている必要があります。
• POファイルのパスおよびプロジェクトに存在する言語のリスト、
• オプションとして、いくつかの大域オプションと、個々のマスターファイルを設定するためのテンプレートとし
て使用される、いわゆる設定エイリアス、
• 翻訳する各マスターファイルとそれぞれに指定する引数の一覧。
各行は角括弧で囲まれた命令とその後に続く引数で構成されています。 コメントは文字 '#' で始まり行末まで続き
ます。行末をエスケープすることで複数行にわたる命令を書けます。
このページでは、いくつかの完全な例を紹介していますが、他の例はソース配布物の"t/cfg"ディレクトリにありま
す。
POファイルとPOTファイルの探索
最も簡単な方法は、以下のようにPOTとPOのファイルへのパスを明示的に指定することです。
[po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po
ここではまずPOTファイルへのパスを指定し、次にドイツ語とフランス語のPOファイルへのパスを指定しています。
同じ意味ですが、コピーアンドペーストでのミスを軽減するために、以下のように書くこともできます。
[po4a_langs] fr de
[po4a_paths] man/po/project.pot $lang:man/po/$lang.po
$lang 構成要素は、与えられた言語一覧から自動的に展開されるため、新しい言語を追加する際のコピーアンドペー
ストでのミスの発生を軽減できます。
以下のように、翻訳プロジェクトを含むディレクトリへのパスを提供するだけで、同じ情報をさらに簡潔にすること
ができます。
[po_directory] man/po/
与えられたディレクトリには、いくつかのPOファイルが含まれていなければなりません。それぞれのファイル名
はXX.poで、"XX"はこのファイルで使用されている言語のISO 639-1形式にしたがったものです。また、ディレクトリ
には、".pot"という拡張子を持つPOTファイルが1つ含まれていなければなりません。初回実行時には、このファイル
は中身が空でも構いませんが、必ず存在しなければなりません（po4aは拡張子の前の部分を推測することはできませ
ん）。
"po_directory" と "po4a_paths" のどちらか一方だけを選択する必要があることに注意してください。前者
（"po_directory"）は、より簡素で、コピー＆ペーストエラーの危険を低減しますが、規定通りのプロジェクト構造
とファイル名を使用する必要があります。後者("po4a_paths")はより明示的で、おそらくより読みやすいので、最初
にpo4aでプロジェクトを立ち上げるときはこちらをお勧めします。
POファイルは一元化すべきか、もしくは分割すべきか？
既定では、po4aは翻訳プロジェクトの全内容を含む、対象言語ごとに1つのPOファイルを生成します。プロジェクトが
大きくなると、これらのファイルの大きさが問題になることがあります。Weblateを使用する場合、各翻訳区分（つま
りmsgid）に優先順位を指定し、重要なものから順に翻訳することが可能です。それでも、翻訳チームは内容をいくつ
かのファイルに分割することを好むことがあります。
マスターファイルごとに1つのPOファイルがあるようにするには、以下のように、"[po4a_paths]" 行でPOファイルの
名前に文字列 $master を使うだけです。
[po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po
この行によってpo4aは翻訳する文書ごとにそれぞれPOTファイルとPOファイルを作成します。例えば3つの文書と5つの
言語がある場合、3つのPOTファイルと15のPOファイルになります。これらのファイルは "po4a_paths" テンプレート
で指定された名前になり、 $master は翻訳するそれぞれの文書の基幹名に置き換えられます。名前が衝突した場合
はPOTファイルで以下のように "pot=" 引数を使って指定できます。
この機能は、複数の翻訳ファイルを同じ POT ファイルにまとめることにも使用できます。次の例では、2つのPOTファ
イルだけが生成されます。l10n/po/foo.pot（foo/gui.xml由来の翻訳材料を含む）と l10n/po/bar.pot（bar/gui.xml
と bar/cli.xml の両方の翻訳材料を含む）です。
[po4a_langs] de fr ja
[po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
[type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo
[type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar
[type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar
分割モードでは、po4a は PO の更新中に一時的な大枠を構築し、すべての PO ファイル間で翻訳を共有します。2つ
のPOファイルが同じ文字列に対して異なる翻訳を持つ場合、po4aはこの文字列をファジーとして印を付け、この文字
列を含むすべてのPOファイルにおいて両方の翻訳を提示します。翻訳者によってファジーが解除されると、その翻訳
がすべての PO ファイルで自動的に使用されます。
翻訳するドキュメントの指定
また、翻訳すべき文書を一覧にする必要があります。それぞれのマスター文書について、使用する形式の構文解析
器、翻訳された文書が生成される場所、そして任意で追加の構成を指定しなければいけません。ファイル名に空白が
含まれている場合は引用符で囲むかエスケープしてください。以下に一例を示します。
[type: sgml] "doc/my stuff.sgml" "fr:doc/fr/mon truc.sgml" de:doc/de/mein\ kram.sgml
[type: man] script fr:doc/fr/script.1 de:doc/de/script.1
[type: docbook] doc/script.xml fr:doc/fr/script.xml \
de:doc/de/script.xml
しかし繰り返しになりますが、これらの複雑な行は読んだり変更したりするのが難しいです。例えば新しい言語を追
加するときなどです。そこで $lang テンプレートを使って以下のようにまとめ直すとより簡素になります。
[type: sgml] doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml
[type: man] script.1 $lang:po/$lang/script.1
[type: docbook] doc/script.xml $lang:doc/$lang/script.xml
オプションの指定
オプションには2種類あります。po4aオプションはpo4aコマンドラインオプションの既定値であり、形式オプションは
形式の構文解析器の動作を変更するために使用されます。po4a オプション として、例えば、--keep コマンドライン
パラメータの既定値を 80% ではなく 50% にすることを設定ファイルに指定することができます。形式オプションは
各構文解析モジュールの個別のページ、例えばLocale::Po4a::Xml(3pm)に記載されています。例え
ば、nostripをXMLパーサーに渡すと、抽出された文字列の周りのスペースを取り除かないようにすることができま
す。
これらのオプションは特定のマスターファイルに対して、あるいはそのファイルの特定の翻訳に対して、"opt:" と
"opt_XX:" を使って "XX" 言語に渡すことができます。次の例では、nostripオプションが（すべての言語に対し
て）XML構文解析器に渡される一方で、フランス語翻訳に対しては閾値が0％に減じられています（したがって、翻訳
は常に維持されます）。
[type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"
いずれにせよ、これらの設定の各区切りは行末に配置しなければなりません。ファイルの宣言が最初に来て、次に補
遺があればそれを（後述）、そしてオプションだけが来るようにしなければなりません。設定の各区切りの集合化
は、内部的には文字列として連結されるためあまり重要ではありません。以下の例はすべて等価です。
[type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
[type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
[type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0
言語固有のオプションは、POT ファイルを構築するときには使用されないことに注意してください。例えば、フラン
ス語の翻訳を構築するときだけ構文解析器に nostrip を渡すことは不可能です。なぜなら、同じ POT ファイルがす
べての言語を更新するために使われるからです。したがって言語固有のオプションは、"--keep"オプションのよう
に、翻訳を作成するときに使用されるものだけです。
設定ファイルのエイリアス
同じオプションを複数のファイルに渡すには、次のように型の別名を定義するのが一番です。次の例では、"--keep
0" が"man" 型の拡張であるこの "test" 型を使用するすべてのイタリア語翻訳に渡されています。
[po4a_alias:test] man opt_it:"--keep 0"
[type: test] man/page.1 $lang:man/$lang/page.1
また、以下のように既存の型を拡張し、別名に同じ名前を再利用することも可能です。これは、誤った再帰的定義と
して解釈されることはありません。
[po4a_alias:man] man opt_it:"--keep 0"
[type: man] man/page.1 $lang:man/$lang/page.1
大域的な既定のオプション
また、"[options]"行を使用し、ファイルの種類に関係なく、すべてのファイルに対して使用しなければならないオプ
ションを定義することができます。
[options] --keep 20 --option nostrip
コマンドラインオプションと同様に、設定ファイルに渡される引数を略すことができます。
[options] -k 20 -o nostrip
オプションの優先順位
各ソースのオプションを連結し、既定値をより具体的なオプションで簡単に上書きできるようになっています。その
順序は以下の通りです。
• "[options]"行は、他のソースで上書き可能な既定値を提供します。
• 種類の別名が使用されます。言語固有の設定は、すべての言語に適用される設定より優先されます。
• 特定のマスターファイルに固有の設定は、既定の設定と種類の別名に由来する設定の両方を上書きします。この
場合、言語固有の設定は大域的な設定より優先されます。
• 最後に、po4aコマンドラインで提供される引数は、設定ファイルの設定を上書きします。
例
ここでは、空白と引用符の使い分けを示す例を示します。
[po_directory] man/po/
[options] --master-charset UTF-8
[po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
[type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose
補遺：翻訳に追記する
もし、翻訳者の著作情報を加えるなど、翻訳に追加の節を追加したい場合は、マスターファイルで定まる行に補遺
ファイルを定義する必要があります。補遺ファイルの構文についてより詳しくは、po4a(7) ページを参照してくださ
い。
[type: pod] script fr:doc/fr/script.1 \
add_fr:doc/l10n/script.fr.add
また、以下のように言語テンプレートを使用することも可能です。
[type: pod] script $lang:doc/$lang/script.1 \
add_$lang:doc/l10n/script.$lang.add
補遺の適用に失敗したら、その翻訳は無視されます。
補遺の宣言用の修飾子
補遺修飾子は、すべての言語では補遺を提供していない場合や、補遺の一覧がある言語と別の言語とで変わってくる
場合に、構成ファイルを単純化できます。修飾子は、ファイル名の前にある単一の文字です。
? ファイルが存在する場合 addendum_path を含めます。なければ何もしません。
@ addendum_path は通常の追加内容ファイルではなく、追加内容ファイルのリスト (1 行 1 ファイル) です。各追加
内容ファイルの前に修飾子を追加できます。
! addendum_path は読み込まれません。また、その他の追加内容で読み込まれるように指定してあっても読み込まれ
ません。
以下では存在する場合にのみいかなる言語においても補遺を含みます。補遺が存在しない場合、エラーは報告されま
せん。
[type: pod] script $lang:doc/$lang/script.1 add_$lang:?doc/l10n/script.$lang.add
以下には各言語向けの補遺の一覧が含まれます。
[type: pod] script $lang:doc/$lang/script.1 add_$lang:@doc/l10n/script.$lang.add
翻訳する文字列の選別
時には、翻訳過程でいくつかの文字列を隠したいことがあります。そのために、マスターファイルに"pot_in"引数を
与えて、POTファイルを構築するときに本当のマスターの代わりに使用するファイルの名前を指定することができま
す。以下はその例です。
[type:docbook] book.xml \
pot_in:book-filtered.xml \
$lang:book.$lang.xml
この設定により、翻訳される文字列はbook-filtered.xml（po4aを呼び出す前に生成されなければなりません）から抽
出され、翻訳ファイルはbook.xmlから構築されることになります。その結果、book.xml には含まれるが
book-filtered.xml には含まれない文字列は PO ファイルに含まれず、翻訳者が翻訳を提供することができなくなり
ます。そのため、これらの文字列は翻訳文書を作成する際に変更されずに残されることになります。これは当然なが
ら翻訳水準を低下させるので、とにかく文書を確実に作成するために"--keep"オプションが必要になるかもしれませ
ん。
関連項目
po4a-gettextize(1)、po4a(7)。
著者
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>
著作権とライセンス
Copyright 2002-2023 by SPI, inc.
本プログラムは自由ソフトウェアです。GPL v2.0以降の条項に基づき再頒布と変更を行えます（COPYINGファイルを参
照）。
perl v5.38.2 2024-08-28 PO4A.1P(1)