名 前
po4a-build − 翻 訳 済 み ド キ ュ メ ン ト の ビ ル ド
概 要
|
po4a−build [−f | −−file FILE] [−−pot−only] |
||
|
po4a−build [−? | −h | −−help | −−version] |
説 明
po4a−build は 、 未 訳 を 提 供 す る の と 同 じ 簡 単 さ で 、 翻 訳 済 み ド キ ュ メ ン ト を 提 供 で き る よ う に す る こ と を 意 図 し て い ま す 。
po4a が POD や DocBook XML と し て 翻 訳 済 み 内 容 を 用 意 す る と 、 po4a−build を 使 用 し て 最 終 ド キ ュ メ ン ト を ビ ル ド で き ま す 。 未 訳 と 翻 訳 済 み の 両 方 の 内 容 は 一 度 の 処 理 で ビ ル ド さ れ 、 併 せ て 同 時 に POT フ ァ イ ル の 更 新 も 行 わ れ ま す 。 既 存 の ビ ル ド 手 順 は po4a−build の 一 回 の 呼 び 出 し に 置 き 換 え ら れ ま す 。 po4a−build が 参 照 す る シ ン プ ル な 設 定 フ ァ イ ル が 使 用 さ れ 、 そ の 中 に は 各 要 素 を ビ ル ド す る 方 法 や 、 翻 訳 済 み と 未 訳 の 内 容 を イ ン ク ル ー ド す る バ イ ナ リ パ ッ ケ ー ジ の 指 定 が 記 述 さ れ ま す 。 ビ ル ド さ れ た 内 容 は 、 設 定 フ ァ イ ル で 指 定 さ れ た BASEDIR の 下 の パ ッ ケ ー ジ 固 有 の デ ィ レ ク ト リ に 置 か れ ま す 。 バ イ ナ リ パ ッ ケ ー ジ foo に ド イ ツ 語 と フ ラ ン ス 語 の 翻 訳 が あ る 場 合 、 以 下 の よ う な 結 果 に な り ま す :
BASEDIR/foo/man/man1/foo.1
BASEDIR/foo/man/de/man1/foo.1
BASEDIR/foo/man/fr/man1/foo.1 こ れ に
よ り 、 同 じ 位
置 に イ ン ス ト
ー ル す る バ イ
ナ リ パ ッ ケ ー
ジ に 生 成 し た
内 容 を す べ て
収 録 す る の が
簡 単 に な り ま
す :
doc/foo/man/*
./usr/share/man/
doc/foo/html/* ./usr/share/doc/foo/ 新 し
い 翻 訳 を 追 加
す る 際 に こ の
規 則 を 更 新 す
る 必 要 は な く
、 別 個 の バ イ
ナ リ パ ッ ケ ー
ジ (bar) を 追 加 す る
こ と に よ っ て
そ の パ ッ ケ ー
ジ の 内 容 を 分
け て お く こ と
が 可 能 と な り
ま す 。 サ ポ ー
ト す る フ ォ ー
マ ッ ト 現 在 、
po4a−build は 以 下 の
組 み 合 わ せ を
サ ポ ー ト し て
い ま す :
1. セ ク シ ョ ン 1 用 DocBook XML。
2. セ ク シ ョ ン 3 用 DocBook XML。
3. HTML 用 DocBook XML。
4. セ ク シ ョ ン 1 用 POD。
5. セ ク シ ョ ン 3 用 POD。
6. セ ク シ ョ ン 5 用 POD。
7. セ ク シ ョ ン 7 用 POD。 対 応 し て い る あ ら ゆ る フ ォ ー マ ッ ト に お い て 、 サ ポ ー ト す る あ ら ゆ る 組 み 合 わ せ を 単 一 の 設 定 フ ァ イ ル po4a−build.conf で 指 示 し 、 た だ po4a−build を 呼 び 出 す だ け で 処 理 さ せ ら れ ま す 。 po4a-build.conf(5) を 参 照 し て く だ さ い 。
設 定
po4a−build は 、 パ ッ ケ ー ジ の VCS 最 上 位 デ ィ レ ク ト リ に 置 か れ る べ き po4a−build.conf を デ フ ォ ル ト 設 定 フ ァ イ ル と し て 使 用 し ま す (ほ か の フ ァ イ ル を 使 用 す る に は −f オ プ シ ョ ン を 使 用 し て く だ さ い )。 po4a-build.conf(5) を 参 照 し て く だ さ い 。 例 1 設 定 例 の フ ァ イ ル 設 定 例 が 書 か れ た フ ァ イ ル は 以 下 の 場 所 に イ ン ス ト ー ル さ れ て い ま す :
/usr/share/doc/po4a/examples/po4a−build.conf.example 設 定 フ ァ イ ル の レ イ ア ウ ト 設 定 フ ァ イ ル は 、 全 般 、 XML/XSL サ ポ ー ト 、 POD サ ポ ー ト 、 HTML サ ポ ー ト の 節 で 構 成 さ れ ま す 。
General includes the name and location of the po4a config file (probably best to leave this as po4a.config), the po directory containing the documentation PO files (often doc/po), the full name of the POT file used to create the translations, the BASEDIR for the generated output, whether the package contains manpages in section 3 rather than just section 1 and the names of the binary packages which are to contain the generated output.
XML/XSL support includes specifying which of the binary packages use XSL support in the XMLPACKAGES variable, the top level DocBook file to pass to xsltproc and the location of the XML or DocBook files. The XSLFILE can be overridden, if necessary.
POD サ ポ ー ト に は 、 PODPACKAGES 変 数 に よ り POD サ ポ ー ト を 使 う バ イ ナ リ パ ッ ケ ー ジ の 指 定 や 、 POD フ ァ イ ル の フ ル ネ ー ム が 含 ま れ ま す 。
HTML サ ポ ー ト で は 、 BASEDIR 以 下 に 作 成 す る 未 訳 と 翻 訳 済 み の HTML 内 容 の サ ブ デ ィ レ ク ト リ や 、 HTML を 生 成 す る DocBook フ ァ イ ル を 指 定 し ま す 。 必 要 な ら HTMLXSL を 上 書 き で き ま す 。
コ マ ン ド
−−pot−only
Only updates the POT file(s). −−pot−only is intended to support packages including all POT files in the package source. Packages using Autotools can easily add the POT file via EXTRA_DIST but packages just using a Makefile or certain VCS build helpers can find it awkward to add the POT file (which is a generated file) without putting the POT file into the VCS. To avoid this ugly and unnecessary work, po4a−build can update the POT file(s) at the start of the build, so that dpkg−source includes them into the source tarball. 例 2 svn−buildpackage の 例
svn−buildpackage は 、 SVN 属 性 の useNativeDist や Make タ ー ゲ ッ ト の native−dist を 使 用 し て 、 こ の 種 の 追 加 を 明 示 的 に サ ポ ー ト し て い ま す 。
# POT フ
ァ イ ル を ソ ー
ス tarball に 追 加
native−dist: Makefile
|
po4a−build −−pot−only |
$ svn propset useNativeDist 1 debian
−h|−−help 使 用 方 法 の メ ッ セ ー ジ を 表 示 し て 終 了 し ま す 。
−−version
print the script version and exit.
オ プ シ ョ ン
−f|−−file FILE
po4a−build は 、 デ フ ォ ル ト の 設 定 フ ァ イ ル (po4a−build.conf) の 代 わ り に オ プ シ ョ ン で 指 定 し た フ ァ イ ル を 使 用 し ま す 。
著 者
po4a−build は Neil Williams <codehelp [AT] debian.org> に よ っ て 書 か れ ま し た 。 こ の マ ニ ュ ア ル ペ ー ジ は Neil Williams <codehelp [AT] debian.org> に よ っ て 書 か れ ま し た