'\" t
.\" Title: po4a-build
.\" Author: [see the "著者" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1
.\" Date: 05/01/2016
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Japanese
.\"
.TH "PO4A\-BUILD" "1" "05/01/2016" "PO4A" "PO4A"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "名前"
po4a-build \- 翻訳ドキュメントの構築
.SH "概要"
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-f\fR | \fB\-\-file\fR\fI
FILE\fR] [\fB\-\-pot\-only\fR]
.HP \w'\fBpo4a\-build\fR\ 'u
\fBpo4a\-build\fR [\fB\-?\fR | \fB\-h\fR | \fB\-\-help\fR | \fB\-\-version\fR]
.SH "説明"
.PP
\fBpo4a\-build\fR
は現在未訳の内容を提供するのと同じように、翻訳したドキュメントを簡単に提供できることを意図しています。
.PP
\fBpo4a\fR
が POD や DocBook XML として翻訳内容を用意すると、\fBpo4a\-build\fR
を使用して最終ドキュメントを構築できます。未訳内容と翻訳内容は共に、単一プロセスで構築され、同時に POT ファイルの更新も行われます。
.PP
既存の構築手順を
\fBpo4a\-build\fR
の呼び出しに置き換え、どのように各要素を構築するのか、翻訳・未訳内容をどのバイナリパッケージに格納するのかといったことを
\fBpo4a\-build\fR
に伝えるシンプルな設定ファイルを使用します。
.PP
一度構築すると、設定ファイルで指定した
\fBBASEDIR\fR
の下にある、パッケージ個別のディレクトリに格納します。バイナリパッケージが foo で、ドイツ語とフランス語の翻訳がある場合、以下のような結果になります。
.sp
.if n \{\
.RS 4
.\}
.nf
BASEDIR/foo/man/man1/foo\&.1
BASEDIR/foo/man/de/man1/foo\&.1
BASEDIR/foo/man/fr/man1/foo\&.1
.fi
.if n \{\
.RE
.\}
.PP
これにより、生成した内容をバイナリパッケージに含める場合に、以下のように一カ所のインストール先を指定するだけになります。
.sp
.if n \{\
.RS 4
.\}
.nf
doc/foo/man/* \&./usr/share/man/
doc/foo/html/* \&./usr/share/doc/foo/
.fi
.if n \{\
.RE
.\}
.PP
この規則だと、新しい訳を追加したり、パッケージを分割したままにしておけるように、第二バイナリパッケージ (bar) を追加しても、更新する必要がありません。
.SS "サポートするフォーマット"
.PP
現在、\fBpo4a\-build\fR
は以下の組み合わせをサポートしています。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 1." 4.2
.\}
セクション 1 用 DocBook XML
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 2." 4.2
.\}
セクション 3 用 DocBook XML
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 3." 4.2
.\}
HTML 用 DocBook XML
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 4." 4.2
.\}
セクション 1 用 POD
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 5." 4.2
.\}
セクション 3 用 POD
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 6." 4.2
.\}
セクション 5 用 POD
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP " 7." 4.2
.\}
セクション 7 用 POD
.RE
.PP
すべてのサポートするフォーマットは、すべての組み合わせを、ひとつの
po4a\-build\&.conf
設定ファイルで扱い、\fBpo4a\-build\fR
を一度呼び出すだけですみます。\fBpo4a-build.conf\fR(5)
をご覧ください。
.SH "設定"
.PP
\fBpo4a\-build\fR
は、パッケージ VCS のトップディレクトリにある
po4a\-build\&.conf
を、デフォルト設定ファイルとして使用します (他のファイルを使用するには
\fB\-f\fR
オプションを使用してください)。\fBpo4a-build.conf\fR(5)
をご覧ください。
.PP
\fB例1 サンプル設定ファイル\fR
.PP
サンプル設定ファイルは以下にあります。
.sp
.if n \{\
.RS 4
.\}
.nf
/usr/share/doc/po4a/examples/po4a\-build\&.conf\&.example
.fi
.if n \{\
.RE
.\}
.SS "設定ファイルレイアウト"
.PP
設定ファイルは、全般、XML/XSL サポート、POD サポート、HTML サポートのセクションから成っています。
.PP
全般には、po4a 設定ファイルの名前や場所 (po4a\&.config
のままにしておくのが最善でしょう) や、ドキュメントの PO ファイルがある po ディレクトリ (通常
doc/po)、翻訳を作成する POT ファイルのフルネーム、生成物を出力する BASEDIR、パッケージのmanpageをセクション 1 ではなくてセクション 3 に格納するかどうか、生成物を格納するバイナリパッケージ名が含まれます。
.PP
XML/XSL サポートには、どのパッケージが XMLPACKAGES 変数により XSL サポートを使うかの指定や、\fBxsltproc\fR
に渡す最上位の DocBookファイル、XML や DocBook ファイルの場所が含まれます。必要なら XSLFILE を上書きできます。
.PP
POD サポートには、どのパッケージが PODPACKAGES 変数により POD サポートを使うかの指定や、POD ファイルのフルネームが含まれます。
.PP
HTML サポートでは、BASEDIR 以下に作成する既訳・未訳 HTML 内容のサブディレクトリや、HTML を生成する DocBook ファイルを指定します。必要なら HTMLXSL を上書きできます。
.SH "コマンド"
.PP
\fB\-\-pot\-only\fR
.RS 4
POT ファイルの更新のみ行います。\fB\-\-pot\-only\fR
は、パッケージソースにあるすべての POT ファイルがパッケージに含まれるように、支援することを意図しています。Autotools を使用したパッケージは、EXTRA_DIST により POT ファイルを簡単に追加できますが、単に Makefile を使用したり、特定の VCS ヘルパーを使用したパッケージは、VCS に POT ファイルを追加せずに、(生成した) POT ファイルを追加するのは厄介であることがわかります。面倒で不要な作業を避けるために、\fBpo4a\-build\fR
は構築開始時に POT ファイルを更新し、\fBdpkg\-source\fR
がソース tarball に含められるようにします。
.PP
\fB例2 svn-buildpackage サンプル\fR
.PP
\fBsvn\-buildpackage\fR
は、この種の追加を明示的にサポートしています。\fBuseNativeDist\fR
SVN 属性と
\fBnative\-dist\fR
Make ターゲットを用います。
.sp
.if n \{\
.RS 4
.\}
.nf
# ソース tarball に POT ファイル追加
native\-dist: Makefile
po4a\-build \-\-pot\-only
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
$ svn propset useNativeDist 1 debian
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-h\fR|\fB\-\-help\fR
.RS 4
使用法メッセージを表示して終了します。
.RE
.PP
\fB\-\-version\fR
.RS 4
使用法メッセージを表示して終了します。
.RE
.SH "オプション"
.PP
\fB\-f\fR|\fB\-\-file\fR\fI FILE\fR
.RS 4
\fBpo4a\-build\fR
のデフォルト設定ファイル (po4a\-build\&.conf) を上書きし、自身でそれを使用します。
.RE
.SH "著者"
.PP
\fBpo4a\-build\fR
は Neil Williams
によって書かれました。
.PP
このマニュアルページは Neil Williams
によって書かれました