名前¶

概要¶

サンプルの Makefile コードを用いると、最小限の労力でパッケージから intltool を利用できます。

レイアウト¶

複数の言語¶

複数の言語を使用する際、POT ファイルに必要な文字列がすべて取得できるまで、po/Makevars で各種設定を実験してください。

具体的には、po/Makevars に二つの言語を指定すると、問題となる可能性があります。こうしないでください:

 # このようにしてはいけません:
 XGETTEXT_OPTIONS = -L Perl -L Shell --from-code=iso-8859-1

翻訳の対象となる言語の一つについて、その言語の全ファイルの名前を変える (またはシンボリックリンクを作成する) ことか、-L オプション による明示の省略を検討してください。ファイルの拡張子は po/POTFILES.in が処理されている間のみ存在する必要があります。

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

po/ への移行¶

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.in と doc/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).

ビルド¶

 clean:
        $(MAKE) -C po/ clean

 install:
        $(MAKE) -C po/ install DESTDIR=$(DESTDIR)

 dist:
        $(MAKE) -C po/ pot

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

保守¶

ソースアーカイブを準備する方法に応じて、MANIFEST ファイルに新しい PO ファイルをリストしたり、アーカイブを準備するスクリプトに追加したりする必要があるでしょう。(これは po4a-build にも適用されます)。

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

著作権¶

著者¶

 Neil Williams <linux@codehelp.co.uk>

訳者¶

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