'\" t
.\" Title: po4a-build
.\" Author: [see the "著者" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 07/06/2018
.\" Manual: PO4A
.\" Source: PO4A
.\" Language: Japanese
.\"
.TH "PO4A\-BUILD" "1" "07/06/2018" "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
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\&.
.PP
XML/XSL support includes specifying which of the binary packages use XSL support in the
\fBXMLPACKAGES\fR
variable, the top level DocBook file to pass to
\fBxsltproc\fR
and the location of the XML or DocBook files\&. The
\fBXSLFILE\fR
can be overridden, if necessary\&.
.PP
POD サポートには、PODPACKAGES 変数により POD サポートを使うバイナリパッケージの指定や、POD ファイルのフルネームが含まれます。
.PP
HTML サポートでは、BASEDIR 以下に作成する未訳と翻訳済みの HTML 内容のサブディレクトリや、HTML を生成する DocBook ファイルを指定します。必要なら HTMLXSL を上書きできます。
.SH "コマンド"
.PP
\fB\-\-pot\-only\fR
.RS 4
Only updates the POT file(s)\&.
\fB\-\-pot\-only\fR
is intended to support packages including all POT files in the package source\&. Packages using Autotools can easily add the POT file via
\fBEXTRA_DIST\fR
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,
\fBpo4a\-build\fR
can update the POT file(s) at the start of the build, so that
\fBdpkg\-source\fR
includes them into the source tarball\&.
.PP
\fB例2 svn\-buildpackage の例\fR
.PP
\fBsvn\-buildpackage\fR
は、SVN 属性の
\fBuseNativeDist\fR
や Make ターゲットの
\fBnative\-dist\fR
を使用して、この種の追加を明示的にサポートしています。
.sp
.if n \{\
.RS 4
.\}
.nf
# POT ファイルをソース tarball に追加
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
print the script version and exit\&.
.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
によって書かれました