Manpages

名 前

po4a−runtime − po4a と Autotools を 使 用 し な い ラ ン タ イ ム gettext 翻 訳

概 要

po4a−build を 併 用 す る こ と に よ り po4a は gettext を 用 い た ラ ン タ イ ム 出 力 メ ッ セ ー ジ の 翻 訳 も サ ポ ー ト し ま す が 、 Autotools お よ び 標 準 的 な ./configure プ ロ セ ス を 採 用 す る 場 合 に は po4a−build パ ッ ケ ー ジ は 必 要 あ り ま せ ん 。 サ ン プ ル の Makefile コ ー ド を 用 い る と 、 最 小 限 の 労 力 で パ ッ ケ ー ジ か ら intltool を 利 用 で き ま す 。

レ イ ア ウ ト

ド キ ュ メ ン ト の 翻 訳 は 、 ラ ン タ イ ム 翻 訳 と 同 じ po/ デ ィ レ ク ト リ を 使 用 す る べ き で は あ り ま せ ん 。 ラ ン タ イ ム 翻 訳 は po/ と 異 な る デ ィ レ ク ト リ を 使 用 で き ま す が 、 通 常 こ の 慣 習 に 従 っ て お く の が 一 番 簡 単 で す 。

複 数 の 言 語

こ れ は 、 複 数 の プ ロ グ ラ ム 言 語 の ス ク リ プ ト を 用 い た パ ッ ケ ー ジ と い う 意 味 で す 。 よ く あ る の が Perl と シ ェ ル の 混 在 で す 。 注 意 : フ ァ イ ル の 拡 張 子 が ほ と ん ど 問 題 の な い も の で あ る 場 合 を 除 き 、 gettext は 混 乱 し て し ま い 、 ど ち ら か の 言 語 を 取 り 除 い て し ま う で し ょ う 。 複 数 の 言 語 を 使 用 す る 際 、 POT フ ァ イ ル に 必 要 な 文 字 列 が す べ て 取 得 で き る ま で 、 po/Makevars で 各 種 設 定 を 実 験 し て く だ さ い 。 具 体 的 に は 、 po/Makevars に 二 つ の 言 語 を 指 定 す る と 、 問 題 と な る 可 能 性 が あ り ま す 。 こ う し な い で く だ さ い :

 # こ の よ う に し て は い け ま せ ん :
 XGETTEXT_OPTIONS = −L Perl −L Shell −−from−code=iso−8859−1翻 訳 の 対 象 と な る 言 語 の 一 つ に つ い て 、 そ の 言 語 の 全 フ ァ イ ル の 名 前 を 変 え る

(ま た は シ ン ボ リ ッ ク リ ン ク を 作 成 す る ) こ と か 、 −L オ プ シ ョ ン に よ る 明 示 の 省 略 を 検 討 し て く だ さ い 。 フ ァ イ ル の 拡 張 子 は po/POTFILES.in が 処 理 さ れ て い る 間 の み 存 在 す る 必 要 が あ り ま す 。

−−keywords オ プ シ ョ ン も 便 利 で す − xgettext(1) の ド キ ュ メ ン ト を ご 覧 く だ さ い 。

po/ へ の 移 行

つ ま り 、 ト ッ プ レ ベ ル の po/ デ ィ レ ク ト リ を 作 成 し 、 /usr/share/doc/po4a/examples/ に あ る サ ン プ ル フ ァ イ ル を 、 移 動 し て く だ さ い 。

LINGUAS 空 だ っ た と し て も 存 在 し な け れ ば な り ま せ ん 。 翻 訳 の リ ス ト で で き て お り 、 ’#’ で 始 ま ら な い 各 行 は 、 存 在 す る PO フ ァ イ ル に 一 致 し な け れ ば な り ま せ ん 。 例 え ば 、 LINGUAS に ’fr’ と だ け 書 か れ て い れ ば 、 fr.po フ ァ イ ル が LINGUAS フ ァ イ ル と 同 じ デ ィ レ ク ト リ に な け れ ば な り ま せ ん 。

 $ cat po/LINGUAS
 cs
 de
 fr
 $慣 例 に よ り 、

LINGUAS フ ァ イ ル は ア ル フ ァ ベ ッ ト 順 に ソ ー ト さ れ て い ま す が 、 そ れ 手 作 業 で す 。

POTFILES .in ラ ン タ イ ム (つ ま り ス ク リ プ ト 内 ) で 翻 訳 さ れ る 必 要 が あ る メ ッ セ ー ジ を 持 つ フ ァ イ ル リ ス ト で す 。 ト ッ プ レ ベ ル po/ デ ィ レ ク ト リ を 使 用 す る 場 合 、 パ ス は po/ デ ィ レ ク ト リ そ の も の で は な く 、 ト ッ プ レ ベ ル デ ィ レ ク ト リ か ら の 相 対 パ ス に し て く だ さ い 。

 $ ls −l
 myscript.pl
 another.pl
 foo/support.pl
 po/
 po/POTFILES.in
 $ cat po/POTFILES.in
 myscript.pl
 another.pl
 foo/support.pl
 $ラ ン タ イ ム の 翻 訳 と ド キ ュ メ ン ト の 翻 訳 の 両 方 を 含 む ス ク リ プ ト

(例 : ラ ン タ イ ム に gettext を 使 用 し 、 ド キ ュ メ ン ト に 埋 め 込 み POD 内 容 を 含 む ) は 、 明 ら か に サ ポ ー ト さ れ る と い う こ と に 注 意 し て く だ さ い 。 そ の た め 、 po/POTFILES.indoc/po4a−build.conf に 、 同 じ フ ァ イ ル が リ ス ト さ れ て い て も 問 題 あ り ま せ ん 。

Makevars−perl.example ス ク リ プ ト が Perl の 場 合 、 こ の サ ン プ ル フ ァ イ ル を po/Makevars と し て コ ピ ー し 、 適 合 す る よ う に 編 集 し て く だ さ い 。
Makevars−shell.example ス ク リ プ ト が シ ェ ル の 場 合 、 こ の サ ン プ ル フ ァ イ ル を po/Makevars と し て コ ピ ー し 、 適 合 す る よ う に 編 集 し て く だ さ い 。
po4a−build.make

Copy this example file as po/Makefile − it shouldn’t need editing but you may want to keep it updated against /usr/share/doc/po4a/examples/po4a−build.make as it may need to be updated within po4a releases as the underlying intltool support changes (the file itself was generated from another project using Autotools and intltool).

ビ ル ド

こ れ ら の ス ニ ペ ッ ト は 、 最 上 位 の Makefile、 ま た は 配 付 の た め の ソ ー ス を 準 備 す る た め に 使 用 す る 方 法 の ど こ か に 組 み 込 む 必 要 が あ り ま す 。

 clean:
        $(MAKE) −C po/ clean
 install:
        $(MAKE) −C po/ install DESTDIR=$(DESTDIR)
 dist:
        $(MAKE) −C po/ pot

(Autotools プ ロ ジ ェ ク ト で は 、 Makefile.am"SUBDIRS"po を 追 加 す る だ け で 、 自 動 的 に こ う な り ま す )

保 守

新 し い 翻 訳 を 加 え る 際 に は 、 po/LINGUAS の 編 集 が 必 要 な の で 、 ラ ン タ イ ム の 翻 訳 は po4a−build と ま っ た く 同 じ よ う に 簡 単 と は 言 え ま せ ん 。 し か し そ れ は 別 に し て 、 翻 訳 の 更 新 は PO フ ァ イ ル を 新 し い バ ー ジ ョ ン に 置 き 換 え る だ け に 過 ぎ ま せ ん 。 ソ ー ス ア ー カ イ ブ を 準 備 す る 方 法 に 応 じ て 、 MANIFEST フ ァ イ ル に 新 し い PO フ ァ イ ル を リ ス ト し た り 、 ア ー カ イ ブ を 準 備 す る ス ク リ プ ト に 追 加 し た り す る 必 要 が あ る で し ょ う 。 (こ れ は po4a−build に も 適 用 さ れ ま す )。

po/ に あ る *.mo*.gmo は す べ て 削 除 さ れ ま す 。

著 作 権

サ ン プ ル フ ァ イ ル は po4a プ ロ ジ ェ ク ト の 一 部 で す が 、 Automake 自 体 の よ う な ほ か の ビ ル ド ツ ー ル と 同 様 に 、 著 作 権 表 示 で po4a を 参 照 し た り 、 po4a チ ー ム を 列 挙 し た り せ ず に 、 あ な た の プ ロ ジ ェ ク ト で 自 由 に 使 用 、 変 更 、 頒 布 で き ま す 。 po4a に 言 及 し て く だ さ る な ら 、 そ れ も ま た す ば ら し い と 思 い ま す 。

著 者

 Neil Williams <linux [AT] codehelp.uk>

訳 者

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