Manpages

名 前

po4a - PO フ ァ イ ル と 翻 訳 済 み ド キ ュ メ ン ト の 両 方 を 一 括 更 新

書 式

po4a [options] config_file

説 明

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

po4a プ ロ グ ラ ム は 、 翻 訳 対 象 が 複 数 だ っ た り 、 フ ォ ー マ ッ ト が 異 な っ た り 、 ド キ ュ メ ン ト ご と に 異 な る オ プ シ ョ ン を 指 定 す る 必 要 が あ る 場 合 に 、 po4a-gettextize(1), po4a-updatepo(1), po4a-translate(1) を 複 雑 な Makefile で 呼 ば な く て す む よ う に な り ま す 。

目 次

こ の ド キ ュ メ ン ト は 以 下 の よ う な 構 成 と な っ て い ま す : 説 明 概 要 設 定 フ ァ イ ル の 書 式 テ ン プ レ ー ト 言 語 の 指 定 翻 訳 者 入 力 フ ァ イ ル の パ ス 指 定 パ ス や 言 語 の 自 動 検 出 翻 訳 す る ド キ ュ メ ン ト の 指 定 モ ジ ュ ー ル オ プ シ ョ ン の 指 定 エ イ リ ア ス の 指 定 分 割 モ ー ド オ プ シ ョ ン 例 欠 点 関 連 項 目 著 者 著 作 権 と ラ イ セ ン ス

概 要

po4a プ ロ グ ラ ム は 、 (オ リ ジ ナ ル ド キ ュ メ ン ト と 同 期 を 取 る ) PO フ ァ イ ル と ( PO フ ァ イ ル と 同 期 を 取 る ) 翻 訳 済 み ド キ ュ メ ン ト の 双 方 の 更 新 を 担 当 し て い ま す 。 主 な 目 的 は 、 コ マ ン ド ラ イ ン オ プ シ ョ ン を 覚 え て お か な く て も 簡 単 に po4a を 使 用 で き る よ う に す る こ と で す 。 ま た 、 異 な る フ ォ ー マ ッ ト が 混 在 し た ド キ ュ メ ン ト を 同 じ POT フ ァ イ ル に で き 、 プ ロ ジ ェ ク ト ご と に 一 つ の フ ァ イ ル で 管 理 で き ま す 。 こ う い っ た こ と は 、 po4a ス イ ー ト の ほ か の ツ ー ル を (例 え ば Makefile と と も に ) 用 い て も 同 様 に で き ま す が 、 少 々 難 し く な り ま す 。 po4a を 使 用 し て い る プ ロ ジ ェ ク ト ご と に 、 そ の よ う な 複 雑 な Makefile を 何 度 も 作 成 す る の は 大 変 で す 。 以 下 に デ ー タ フ ロ ー を ま と め ま し た 。 マ ス タ ー ド キ ュ メ ン ト の 変 更 を PO フ ァ イ ル に 反 映 し 、 PO フ ァ イ ル の 変 更 を (手 で の 修 正 で も 前 述 の ス テ ッ プ で も ) 翻 訳 済 み ド キ ュ メ ン ト に 反 映 し ま す 。

Normal case without specifying pot_in:

 <- source files ->|<--------- build results --------------->
 addendum ----------------------------------+
                                            |
 master document --+---------------------+  |
                   V                     +--+--> translations
 old PO files -----+--> updated PO files +
      ^                      |
      |                      V
      +<.....................+
    (the updated PO files are manually
     copied to the source of the next
     release while manually updating
     the translation contents)

Special case with specifying pot_in:

 <- source files ->|<--------- build results ----------------->
 master document --+--------------------------+:
                                              |
 external          :    filtered              |
 filtering ========X..> master                |
 program                document              |
                        |                     |
                        V                     +--> translations
 old PO files ----------+--> updated PO files +
      ^                           |
      |                           V
      +<..........................+
    (the updated PO files are manually
     copied to the source of the next
     release while manually updating
     the translation contents)

The dataflow cannot be reversed in this tool, and changes in translations are overwritten by the content of the PO files. As a matter of fact, this tool cannot be used to convert existing translations to the po4a system. For that task, please refer to po4a-gettextize(1).

設 定 フ ァ イ ル の 書 式

(必 須 の ) 引 数 は 、 使 用 す る 設 定 フ ァ イ ル の パ ス で す 。 こ の 文 法 は 単 純 で あ る こ と を 目 指 し て お り 、 intl-tools プ ロ ジ ェ ク ト で 使 う 設 定 フ ァ イ ル に 似 て い ま す 。 こ の フ ァ イ ル で は 、 ’#’ に 続 け て コ メ ン ト を 記 述 で き 、 行 末 ま で を す べ て コ メ ン ト に し ま す 。 行 末 を エ ス ケ ー プ し て 、 行 を つ な げ る こ と も で き ま す 。 空 行 で な い 行 は [] コ マ ン ド で 始 め 、 引 数 が 続 か な け れ ば な り ま せ ん (こ う い う と 難 し く 聞 こ え ま す が 、 思 っ た よ り 簡 単 だ と 思 い ま す ;) )。 テ ン プ レ ー ト 言 語 の 指 定 注 意 : [po4a_langs] と [po4a_paths] よ り も [po_directory] の 使 用 を お 勧 め し ま す 。 後 述 す る パ ス や 言 語 の 自 動 検 出 を 参 照 し て く だ さ い 。 こ れ は 設 定 フ ァ イ ル 全 体 を 単 純 に し 、 よ り 柔 軟 に す る オ プ シ ョ ン コ マ ン ド で す 。 ド キ ュ メ ン ト を 翻 訳 し た い 言 語 の リ ス ト を 指 定 し な け れ ば な り ま せ ん 。 こ れ は 、 以 下 の よ う に 単 純 で す :

[po4a_langs] fr de 設 定 フ ァ イ ル の 残 り の 部 分 で $lang を 指 定 し た 言 語 に 展 開 す る よ う に な り ま す 。 翻 訳 者 入 力 フ ァ イ ル の パ ス 指 定 注 意 : [po4a_langs] と [po4a_paths] よ り も [po_directory] の 使 用 を お 勧 め し ま す 。 後 述 す る パ ス や 言 語 の 自 動 検 出 を 参 照 し て く だ さ い 。 ま ず 、 翻 訳 者 入 力 フ ァ イ ル (翻 訳 者 が 自 分 の 作 業 に 使 用 す る フ ァ イ ル ) の 位 置 を 指 定 す る 必 要 が あ り ま す 。 以 下 の よ う な 行 で 行 い ま す :

 [po4a_paths] doc/l10n/project.doc.pot \
              fr:doc/l10n/fr.po de:doc/l10n/de.poコ マ ン ド は 、 し た が っ て

[po4a_paths] で す 。 第 一 引 数 は 、 使 用 す る POT フ ァ イ ル の パ ス で す 。 以 降 の 引 数 は す べ て 自 明 の 形 式 で す :

<言 語 >:<こ の 言 語 の PO フ ァ イ ル へ の パ ス > テ ン プ レ ー ト 言 語 を 定 義 し て い れ ば 、 前 述 の 行 は 以 下 の よ う に も 書 き 直 せ ま す :

[po4a_paths] doc/l10n/project.doc.pot $lang:doc/l10n/$lang.po ド キ ュ メ ン ト の フ ァ イ ル 名 を 参 照 す る の に $master も 使 用 で き ま す 。 こ の 場 合 、 po4a は 分 割 モ ー ド と な り 、 po4a の 設 定 フ ァ イ ル で 指 定 し た 各 ド キ ュ メ ン ト に つ い て 、 POT フ ァ イ ル と (言 語 ご と の ) PO フ ァ イ ル を 一 つ ず つ 作 成 し ま す 。 分 割 モ ー ド 節 を 参 照 し て く だ さ い 。

[po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po パ ス や 言 語 の 自 動 検 出
PO フ ァ イ ル や POT フ ァ イ ル の 位 置 を デ ィ レ ク ト リ の 名 前 で 指 定 す る た め に 使 用 す る 別 の コ マ ン ド が あ り ま す 。 こ れ を 使 用 す る と 、 po4a は 、 指 定 し た デ ィ レ ク ト リ に あ る *.pot フ ァ イ ル の み を POT フ ァ イ ル と し て 検 出 し ま す 。 ま た po4a は 、 *.po フ ァ イ ル の リ ス ト を 言 語 の リ ス ト と し て (拡 張 子 を 除 い て ) 定 義 し ま す 。 こ の 言 語 は 、 設 定 フ ァ イ ル の 残 り の 部 分 で $lang 変 数 を 置 換 す る の に 使 用 さ れ ま す 。 こ の コ マ ン ド は 、 [po4a_langs] コ マ ン ド や [po4a_paths] コ マ ン ド と 同 時 に 使 用 す る べ き で は あ り ま せ ん 。 こ の コ マ ン ド を 使 用 す る 際 、 POT フ ァ イ ル の 名 前 を 知 ら せ る た め 、 po4a の 初 回 起 動 時 に 空 の POT フ ァ イ ル を 作 る 必 要 が あ り ま す 。

[po_directory] po4a/po/ 翻 訳 す る ド キ ュ メ ン ト の 指 定 さ て 、 当 た り 前 で す が 、 翻 訳 対 象 の ド キ ュ メ ン ト や そ の フ ォ ー マ ッ ト 、 翻 訳 の 置 き 場 所 を 指 定 し な け れ ば な り ま せ ん 。 以 下 の 行 の よ う に 指 定 で き ま す :

 [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
              de:doc/de/mein_kram.sgml
 [type: pod] script fr:doc/fr/script.1 de:doc/de/script.1 \
             add_fr:doc/l10n/script.fr.add
 [type: docbook] doc/script.xml fr:doc/fr/script.xml \
             de:doc/de/script.xml \
             pot_in:doc/script.filtered.xmlこ れ も ま た か な り 自 己 説 明 的 だ と 思 い ま す 。 二 番 目 の ケ ー ス では 、

doc/l10n/script.fr.add は 、 こ の ド キ ュ メ ン ト の フ ラ ン ス 語 版 に 追 加 す る 追 加 内 容 で す 。 追 加 内 容 に つ い て の 詳 細 情 報 は po4a(7) を 参 照 し て く だ さ い 。 も っ と 形 式 張 っ て 言 う と 、 フ ォ ー マ ッ ト は 以 下 の よ う に な り ま す :

 [type: <format>] <master_doc> (<lang>:<localized_doc>)* \
                  (pot_in:<filtered_master_doc>)? \
                  (add_<lang>:<modifier>*<addendum_path>)*

If pot_in is specified, filtered_master_doc is used to create POT file instead of master_doc. This feature allows user to create flexible ways to avoid contents which shouldn’t be included in the PO files. Tools such as C preprocessor (cpp) or XSL Transformation utility (e.g., xsltproc) can be used to create the external filtering program and call it before invoking po4a. 修 飾 子 が な い 場 合 、 addendum_path は 追 加 内 容 へ の パ ス に な り ま す 。 修 飾 子 は 以 下 に な り ま す 。

? フ ァ イ ル が 存 在 す る 場 合

addendum_path を 含 め ま す 。 な け れ ば 何 も し ま せ

ん 。

@

addendum_path は 通 常 の 追 加 内 容 フ ァ イ ル で は な く 、 追 加 内 容 フ ァ イ ル の リ ス ト (1 行 1 フ ァ イ ル ) で す 。 各 追 加 内 容 フ ァ イ ル の 前 に 修 飾 子 を 追 加 で き ま す 。

!

addendum_path は 読 み 込 ま れ ま せ ん 。 ま た 、 そ の 他 の 追 加 内 容 で 読 み 込 ま れ る よ う に 指 定 し て あ っ て も 読 み 込 ま れ ま せ ん 。

テ ン プ レ ー ト 言 語 を 定 義 し て い れ ば 、 前 述 の 行 は 以 下 の よ う に も 書 き 直 せ ま す :

 [type: pod] script $lang:doc/$lang/script.1 \
             add_fr:doc/l10n/script.fr.addす べ て の 言 語 が 同 様 の パ ス で 追 加 内 容 を 持 っ て い た 場 合 、 以 下 の よ う に も 書 くこ と が で き ま す :

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.addモ ジ ュ ー ル オ プ シ ョ ン の 指 定

po4a は モ ジ ュ ー ル に 渡 す オ プ シ ョ ン を 受 け 付 け ま す 。 渡 す オ プ シ ョ ン は モ ジ ュ ー ル 固 有 で 、 -o ス イ ッ チ に よ り 指 定 さ れ ま す 。

If you need a specific option for one of the documents you want to translate, you can also specify it in the configuration file. Options are introduced by the opt keyword. The argument of the opt keyword must be quoted with double quotes if it contains a space (e.g. if you specify multiple options, or an option with an argument). You can also specify options that will only apply to a specific language by using the opt_lang keyword. 例 を 示 し ま す :
[type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
opt:"-k 75" opt_it:"-L UTF-8" opt_fr:-v シ ン グ ル ク ォ ー ト ま た は エ ス ケ ー プ し た ダ ブ ル ク ォ ー ト を 使 う と 、 引 数 に 空 白 を 含 め る こ と が で き ま す :
[po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\" -k 20" た く さ ん の ド キ ュ メ ン ト で 同 じ オ プ シ ョ ン を 指 定 し た い 場 合 は 、 エ イ リ ア ス を 利 用 で き ま す (以 下 の エ イ リ ア ス の 指 定 節 を 参 照 し て く だ さ い )。 設 定 フ ァ イ ル の 中 で 、 す べ て の ド キ ュ メ ン ト に 対 す る オ プ シ ョ ン の 指 定 も で き ま す :
[options] opt:"..." opt_fr:"..." エ イ リ ア ス の 指 定 複 数 の フ ァ イ ル に 同 じ オ プ シ ョ ン を 指 定 し な け れ ば な ら な い 場 合 は 、 モ ジ ュ ー ル エ イ リ ア ス を 定 義 す る と 便 利 で す 。 以 下 の よ う に し て く だ さ い :

[po4a_alias:test] man opt:"-k 21" opt_es:"-o debug=splitargs" こ の 例 で は man モ ジ ュ ー ル を 元 に し た test と い う モ ジ ュ ー ル エ イ リ ア ス を 定 義 し 、 全 言 語 に -k 21 を 適 用 し 、 ス ペ イ ン 語 の 翻 訳 に は -o debug=splitargs を 適 用 し ま す 。

This module alias can then be used like a regular module:

 [type:test] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
            opt_it:"-L UTF-8" opt_fr:-vフ ァ イ ル ご と の 追 加 オ プ シ ョ ン も 指 定 で き る こ と に 注 意 し て く だ さ い 。分 割 モ ー ド

[po4a_paths] 行 に $master を 使 う と 分 割 モ ー ド に な り ま す 。 分 割 モ ー ド を 使 用 す る 際 、 一 時 的 に 大 き な POT フ ァ イ ル と 大 き な PO フ ァ イ ル を 使 用 し ま す 。 こ れ に よ り 、 す べ て の PO 間 で 翻 訳 を 共 有 で き ま す 。 二 つ の PO で 同 じ 文 字 列 に 対 し て 異 な る 翻 訳 が さ れ て い る 場 合 、 po4a は そ の 文 字 列 を fuzzy と し て マ ー ク し 、 そ の 文 字 列 を 持 つ す べ て の PO に 両 方 の 訳 を 出 力 し ま す 。 そ の 場 合 、 翻 訳 者 は 訳 を 更 新 し 、 一 つ の PO か ら fuzzy タ グ を 取 り 除 く と 、 こ の 文 字 列 の 訳 は す べ て の PO で 自 動 的 に 更 新 さ れ ま す 。 同 一 の フ ァ イ ル 名 が 存 在 す る た め 競 合 を 起 こ す 場 合 、 次 の よ う に "master:file="name オ プ シ ョ ン を 追 加 し て マ ス タ ー フ ァ イ ル 名 を 指 定 で き ま す :

 [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 master:file=foo-gui
 [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml master:file=bar-gui

オ プ シ ョ ン

-k, --keep

Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to get written.

-h, --help 短 い ヘ ル プ メ ッ セ ー ジ を 表 示 し ま す 。
-M, --master-charset 翻 訳 す る ド キ ュ メ ン ト を 含 む フ ァ イ ル の 文 字 セ ッ ト で す 。 す べ て の マ ス タ ー ド キ ュ メ ン ト が 、 同 じ 文 字 セ ッ ト を 使 用 し て い な け れ ば な ら な い こ と に 注 意 し て く だ さ い 。 こ れ は 既 知 の 制 限 で 、 こ れ を 解 消 し よ う と 作 業 を し て い ま す 。
-L, --localized-charset 地 域 化 し た ド キ ュ メ ン ト を 含 む フ ァ イ ル の 文 字 セ ッ ト で す 。 す べ て の 翻 訳 済 み ド キ ュ メ ン ト が 、 同 じ 文 字 セ ッ ト を 使 用 す る こ と に 注 意 し て く だ さ い 。 こ れ は 既 知 の 制 限 で 、 こ れ を 解 消 し よ う と 作 業 を し て い ま す 。
-A, --addendum-charset 追 加 内 容 の 文 字 セ ッ ト で す 。 追 加 内 容 で は 、 す べ て 同 じ 文 字 セ ッ ト を 使 用 す る こ と に 注 意 し て く だ さ い 。
-V, --version ス ク リ プ ト の バ ー ジ ョ ン を 表 示 し て 終 了 し ま す 。
-v, --verbose プ ロ グ ラ ム の 冗 長 度 を 上 げ ま す 。
-q, --quiet プ ロ グ ラ ム の 冗 長 度 を 下 げ ま す 。
-d, --debug デ バ ッ グ 情 報 を 出 力 し ま す 。
-o, --option フ ォ ー マ ッ ト プ ラ グ イ ン に 渡 す 追 加 オ プ シ ョ ン で す 。 各 オ プ シ ョ ン は 、 ’name=value’ の フ ォ ー マ ッ ト で 指 定 し て く だ さ い 。 有 効 な オ プ シ ョ ン や そ の 意 味 の 詳 細 は 、 各 プ ラ グ イ ン の ド キ ュ メ ン ト を 参 照 し て く だ さ い 。
-f, --force 生 成 の 必 要 は な い と po4a が 判 断 し た 場 合 で も 、 常 に POT フ ァ イ ル と PO フ ァ イ ル を 生 成 し ま す 。 デ フ ォ ル ト の 動 作 (--force を 指 定 し な い 場 合 ) は 以 下 の よ う に な り ま す :

POT フ ァ イ ル が 存 在 す る 場 合 、 マ ス タ ー ド キ ュ メ ン ト や 設 定 フ ァ イ ル の 方 が 新 し け れ ば 、 再 生 成 し ま す 。 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

Do not change the POT and PO files, only the translation may be updated.

--keep-translations

Keeps the existing translation files even if the translation doesn’t meet the threshold specified by --keep. This option does not create new translation files with few content, but it will save existing translations which decay because of changes to the master files.

WARNING: This flag changes the po4a behavior in a rather drastic way: your translated files will not get updated at all until the translation improves. Only use this flag if you prefer shipping an outdated translated documentation rather than only shipping an accurate untranslated documentation.

--rm-translations 翻 訳 済 み フ ァ イ ル を 削 除 し ま す (--no-translations を 暗 に 意 味 し ま す )。
--no-backups こ の フ ラ グ は 0.41 か ら 何 も し な く な り ま し た 。 ま た 今 後 の リ リ ー ス で 削 除 さ れ る 可 能 性 が あ り ま す 。
--rm-backups こ の フ ラ グ は 0.41 か ら 何 も し な く な り ま し た 。 ま た 今 後 の リ リ ー ス で 削 除 さ れ る 可 能 性 が あ り ま す 。
--translate-only translated-file 指 定 し た フ ァ イ ル に 対 す る 翻 訳 の み 行 い ま す 。 設 定 フ ァ イ ル 内 に フ ァ イ ル が た く さ ん 指 定 さ れ て い る 場 合 、 処 理 の 高 速 化 に 役 立 つ こ と で し ょ う 。 こ の オ プ シ ョ ン は 、 PO フ ァ イ ル と POT フ ァ イ ル の 更 新 を 行 わ な い こ と に 注 意 し て く だ さ い 。 こ の オ プ シ ョ ン は 複 数 回 指 定 で き ま す 。
--variable var=value

po4a 設 定 フ ァ イ ル 内 で 展 開 す る 変 数 を 定 義 し ま す 。 現 れ る す べ て の $(var) は 、 value に 置 換 さ れ ま す 。 こ の オ プ シ ョ ン は 複 数 回 使 用 で き ま す 。

--srcdir SRCDIR

po4a 設 定 フ ァ イ ル で 指 定 さ れ た す べ て の 入 力 ド キ ュ メ ン ト に 対 す る ベ ー ス デ ィ レ ク ト リ を 指 定 し ま す 。

--destdir DESTDIR

po4a 設 定 フ ァ イ ル で 指 定 さ れ た す べ て の 出 力 ド キ ュ メ ン ト に 対 す る ベ ー ス デ ィ レ ク ト リ を 指 定 し ま す 。

POT ヘ ッ ダ を 変 更 す る オ プ シ ョ ン
--porefs type[,wrap|nowrap]

Specify the reference format. Argument type can be one of never to not produce any reference, file to only specify the file without the line number, counter to replace line number by an increasing counter, and full to include complete references (default: 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" で す 。

PO フ ァ イ ル を 変 更 す る オ プ シ ョ ン
--msgmerge-opt options

msgmerge(1) 用 の 追 加 オ プ シ ョ ン で す 。 注 意 : $lang は 現 在 の 言 語 へ 展 開 さ れ ま す 。

--no-previous こ の オ プ シ ョ ン は 、 msgmerge に 渡 す オ プ シ ョ ン か ら --previous を 削 除 し ま す 。 こ れ に よ り 0.16 よ り 前 の gettext を サ ポ ー ト で き ま す 。
--previous こ の オ プ シ ョ ン は 、 msgmerge に 渡 す オ プ シ ョ ン に --previous を 追 加 し ま す 。 gettext 0.16 以 降 が 必 要 で 、 デ フ ォ ル ト で 有 効 で す 。 例 あ な た は foo と い う プ ロ グ ラ ム を 保 守 し て お り 、 そ の プ ロ グ ラ ム に は 当 然 の よ う に 英 語 の み で 書 か れ て い る man/foo.1 と い う man ペ ー ジ が あ る と 仮 定 し ま し ょ う 。 今 、 上 流 な い し 下 流 の メ ン テ ナ と し て の あ な た は 、 翻 訳 を 作 成 し 、 保 守 し た い と 考 え て い ま す 。 ま ず 、 po4a-gettextize(1) を 使 用 し て 、 翻 訳 者 に 送 る た め に 必 要 な POT フ ァ イ ル を 作 成 す る 必 要 が あ り ま す 。 こ の 場 合 、 以 下 の よ う に 実 行 し ま す

cd man && po4a-gettextize -f man -m foo.1 -p foo.pot 次 に こ の フ ァ イ ル を 、 適 切 な 言 語 の メ ー リ ン グ リ ス ト に 送 る か 、 ダ ウ ン ロ ー ド で き る よ う ウ ェ ブ サ イ ト の ど こ か に 用 意 す る こ と に な り ま す 。 こ こ で 、 次 の リ リ ー ス ま で の 間 に 、 de.po (追 加 内 容 de.add を 含 む )、 sv.po、 pt.po の 三 つ の 翻 訳 を 受 け 取 っ た と し ま し ょ う 。 新 し い 翻 訳 が 届 く た び に 、 Makefile を 変 更 し た く は あ り ま せ ん 。 こ の 場 合 、 適 切 な 設 定 フ ァ イ ル を 用 意 し た po4a を Makefile 内 で 使 用 で き ま す 。 こ れ を po4a.cfg と 呼 び ま し ょ う 。 先 ほ ど の 例 は 、 以 下 の よ う に な り ま す :

 [po_directory] man/po4a/po/
 [type: man] man/foo.1 $lang:man/translated/$lang/foo.1 \
            add_$lang:?man/po4a/add_$lang/$lang.add opt:"-k 80"こ の 例 で は 、 生 成 し た

man ペ ー ジ (と す べ て の PO フ ァ イ ル と 追 加 内 容 フ ァ イ ル ) は 、 カ レ ン ト デ ィ レ ク ト リ 以 下 の man/translated/$lang/ (そ れ ぞ れ man/po4a/po/ と man/po4a/add_$lang/) に 格 納 す る と し ま す 。 こ の 例 で は 、 man/po4a/po/ に de.po, pt.po, sv.po が あ り 、 man/po4a/add_de/ デ ィ レ ク ト リ に de.add が あ り ま す 。 追 加 内 容 が あ る の は ド イ ツ 語 翻 訳 (de.po) だ け で あ る た め に 修 飾 子 ? を 使 っ て い る こ と に 注 意 し て く だ さ い 。 実 際 に 翻 訳 済 み man ペ ー ジ を ビ ル ド す る に は 、 適 切 な Makefile の ビ ル ド タ ー ゲ ッ ト に 次 の 行 を (一 度 だ け !) 追 加 し ま す :

        po4a po4a.cfg

Once this is set up you don’t need to touch the Makefile when a new translation arrives, i.e. if the French team sends you fr.po and fr.add then you simply drop them respectively in man/po4a/po/ and man/po4a/add_fr/ and the next time the program is built the French translation is automatically build as well in man/translated/fr/. 英 語 の マ ニ ュ ア ル ペ ー ジ と 翻 訳 さ れ た マ ニ ュ ア ル ペ ー ジ を 同 時 に イ ン ス ト ー ル す る た め に 、 適 切 な タ ー ゲ ッ ト が 必 要 な こ と に 注 意 し て く だ さ い 。 最 後 に 、 生 成 し た フ ァ イ ル を バ ー ジ ョ ン 管 理 シ ス テ ム に 格 納 し た く な け れ ば 、 clean タ ー ゲ ッ ト に 以 下 の よ う な 行 が 必 要 に な る で し ょ う :
-rm -rf man/translated

欠 点

• い く つ か の コ ー ド は

po4a-* プ ロ グ ラ ム と 重 複 し て い ま す 。

パ ッ チ を 歓 迎 し ま す ;)

関 連 項 目

po4a-gettextize(1), po4a-normalize(1), po4a-translate(1), po4a-updatepo(1), po4a(7)

著 者 

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

訳 者

倉 澤 望 <nabetaro [AT] debian.jp>
Debian JP Documentation ML <debian-doc [AT] debian.jp>

著 作 権 と ラ イ セ ン ス

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