.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "PO4A-BUILD.CONF 5"
.TH PO4A-BUILD.CONF 5 "2018-05-27" "Po4a Tools" "Po4a Tools"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "名前"
.IX Header "名前"
po4a\-build.conf \- 翻訳済み内容ビルド用設定ファイル
.SH "概要"
.IX Header "概要"
\&\fIpo4a\-build.conf\fR は、翻訳されていないソース群およびそれぞれに対応する \s-1PO\s0
ファイルから翻訳済みと未訳のドキュメントをビルドする方法を記述します。
.PP
対応しているあらゆるフォーマットにおいて、サポートするあらゆる組み合わせは単一の設定ファイル \fIpo4a\-build.conf\fR で指示し、ただ
\&\f(CW\*(C`po4a\-build\*(C'\fR を呼び出すだけで処理できます。しかし、\fIpo/\fR ディレクトリを分割し、各実行を一つの設定ファイルで扱うことも選択できます
(それぞれ \f(CW\*(C`po4a\-build \-f FILE\*(C'\fR を呼び出してください)。
.PP
\&\fIpo4a\-build\fR にスクリプト出力メッセージ翻訳用の gettext
サポート追加が含まれているといっても、\fIpo4a\-build.conf\fR
自体はそのような翻訳をサポートしていないことに注意してください。\fIpo4a\-build.conf\fR は、manpage
のような静的内容の翻訳にのみ関係します。
.PP
ランタイムメッセージ翻訳の \fIpo4a\-build\fR サポートについては、\fIpo4a\-runtime\fR\|(7) を参照してください。
.SH "サポートするフォーマット"
.IX Header "サポートするフォーマット"
現在、\f(CW\*(C`po4a\-build\*(C'\fR は以下の組み合わせをサポートしています:
.IP "セクション 1, 3 用 DocBook \s-1XML\s0" 4
.IX Item "セクション 1, 3 用 DocBook XML"
通常、POD のような独自のドキュメントフォーマットを持たないシェルスクリプトやその他のインタプリタで利用されます。既存の manpage から
\&\f(CW\*(C`doclifter\*(C'\fR(1) を用いて直接適合する \s-1XML\s0 を生成でき、余計な作業負荷もなく \f(CW\*(C`po4a\-build\*(C'\fR で \s-1POT\s0
ファイルを生成できます。その生成した \s-1POT\s0 ファイルは翻訳用に提供でき、適切な \fIpo/\fR ディレクトリに \s-1PO\s0
ファイルを配置できます。さらに、\f(CW\*(C`po4a\-build\*(C'\fR は \f(CW\*(C`doclifter\*(C'\fR \s-1XML\s0 による未訳 manpage だけでなく、\f(CW\*(C`PO4a\*(C'\fR
も利用して翻訳済み \s-1XML\s0 を \s-1PO\s0 ファイルから生成し、その \s-1XML\s0 から翻訳済み manpage をビルドします。
.Sp
デフォルトでは docbook-xsl を用いて manpage を生成します。\f(CW\*(C`po4a\-build\*(C'\fR 設定ファイルの \f(CW\*(C`XSLFILE\*(C'\fR
設定を用いて使用するスタイルシートを上書きできます。
.IP "\s-1HTML\s0 用 DocBook \s-1XML\s0" 4
.IX Item "HTML 用 DocBook XML"
最終的に \s-1HTML\s0 を準備するスタイルシートは、デフォルトのままにしておけます。また、\f(CW\*(C`po4a\-build\*(C'\fR 設定ファイルの \f(CW\*(C`HTMLXSL\*(C'\fR
設定を用いて上書きできます。
.IP "セクション 1, 3, 5, 7 用 \s-1POD\s0" 4
.IX Item "セクション 1, 3, 5, 7 用 POD"
サポートする各セクション用に \s-1POD\s0 内容を pod2man で変換します。
.Sp
セクション 1 向けに \f(CW\*(C`PODFILE\*(C'\fR、セクション 3 向けに \f(CW\*(C`PODMODULES\*(C'\fR、セクション 5 向けに
\&\f(CW\*(C`POD5FILES\*(C'\fR、セクション 7 向けに \f(CW\*(C`POD7FILES\*(C'\fR を使用してください。
.Sp
セクション 5、7 の内容のファイル名の一部に 5 や 7 が含まれる場合は、(セクション 1
の内容でも使われるファイル名にしなければならない傾向があるので) ファイル名の拡張子と共に 5 や 7 が自動的に取り除かれます。
.Sp
例えば \fI/usr/share/man/man7/po4a.7.gz\fR を準備するには:
.Sp
.Vb 2
\& # セクション 7 用 POD
\& POD7FILES="doc/po4a.7.pod"
.Ve
.SH "ファイル内容"
.IX Header "ファイル内容"
設定値は設定ファイル内でどのような順番でもかまいません。
.PP
\&'#' 以降の内容を無視します。
.PP
常に空になる値は、ファイルから取り除けます。
.PP
設定フィールドのいくつかは必須です。必須フィールドを空にすると、\fIpo4a\-build\fR は何もせずに終わります。
.IP "\s-1CONFIG\s0" 4
.IX Item "CONFIG"
必須です。
.Sp
\&\f(CW\*(C`po4a\-build\*(C'\fR が生成して管理する (一時的な) \f(CW\*(C`po4a\*(C'\fR
設定ファイルの名前と位置です。このファイルは、バージョン管理システムの管理下にある必要はなく、パッケージのビルドの過程で安全に削除できます。
.Sp
.Vb 2
\& # 設定ファイルの名前と位置
\& CONFIG="_build/po4a.config"
.Ve
.IP "\s-1PODIR\s0" 4
.IX Item "PODIR"
必須です。
.Sp
この設定ファイルで扱うすべての翻訳用 \s-1PO\s0 ファイルを格納するディレクトリです。文字列はすべてこのディレクトリにある \s-1POT\s0 ファイルにマージされ、全
\&\s-1PO\s0 ファイルを この \s-1POT\s0 ファイルとマージします。KEEP 閾値 (後述)
は、このファイルで指定した全入力ファイルの全文字列と、このディレクトリにある全 \s-1PO\s0 ファイルに適用されます。ディレクトリは 'po'
と言う名前である必要はありません。しかし、いくつかの統計ツールは名前が 'po'
であることを求めています。したがって、この名前のままにすることが推奨されることに注意してください。
.Sp
.Vb 2
\& # manpage/doc 用 po ディレクトリ
\& PODIR="po/pod"
.Ve
.IP "\s-1POTFILE\s0" 4
.IX Item "POTFILE"
必須です。
.Sp
\&\s-1POT\s0 ファイルへのパス (この設定ファイルの位置からの相対パス) です。ここに対して \f(CW\*(C`po4a\-build\*(C'\fR
が翻訳を生成し、保守や更新を行います。
.Sp
.Vb 2
\& # POT ファイルのパス
\& POTFILE="po/pod/po4a\-pod.pot"
.Ve
.IP "\s-1BASEDIR\s0" 4
.IX Item "BASEDIR"
必須です。
.Sp
翻訳内容を書き出すベースディレクトリ。
.Sp
.Vb 2
\& # 生成したファイルのベースディレクトリ、例: doc
\& BASEDIR="_build"
.Ve
.IP "\s-1BINARIES\s0" 4
.IX Item "BINARIES"
必須です。
.Sp
単一パッケージをビルドするとしても、少なくとも一つは値が必要です。
.Sp
この文字列は任意ですが、通常パッケージ名からできています。生成した内容は、以下のように \fI\s-1BASEDIR/BINARIES\s0\fR
のサブディレクトリに現れます:
.Sp
.Vb 1
\& _build/po4a/man/man1/foo.1
.Ve
.Sp
複数のバイナリパッケージをビルドする場合 (つまり、一つのソースパッケージと複数の .deb ファイルや .rpm
ファイル)、このフィールドは各ターゲットを対象とした内容を分離することで、ビルドプロセスの自動化を簡単にします。
.Sp
空白で文字列を分割します。
.Sp
.Vb 2
\& # 生成した manpage を含むバイナリパッケージ
\& BINARIES="po4a"
.Ve
.IP "\s-1KEEP\s0" 4
.IX Item "KEEP"
特定の翻訳がビルドから除外される前に \f(CW\*(C`po4a \-k\*(C'\fR
に直接渡される、正しく翻訳される内容の閾値です。空のままにしたり、削除したりするとデフォルト値 (80%) を使用します。また、0
にすると、まったく訳されていなくても、強制的にすべての内容を含めるようになります。
.Sp
そのような挙動をすべて制御するために、どのファイルをどの \fIpo4a\-build.conf\fR 設定ファイルに割り当てるかを慎重に決めてください。
.Sp
翻訳者にとっては \s-1POT\s0 ファイルにたくさんのファイルが含まれていると (特に共通する文字列が多いと) 都合がよいですが、逆に \s-1POT\s0
ファイルにたくさんの長い文字列があると、文字列の確定に時間がかかり、翻訳者の気力を奪ってしまうということに注意してください。
.Sp
.Vb 2
\& # 維持する翻訳率のしきい値
\& KEEP=
.Ve
.IP "\s-1XMLMAN1\s0" 4
.IX Item "XMLMAN1"
セクション 1 の manpage を生成するための DocBook \s-1XML\s0 です。ファイル名は空白で区切られます。すべてのファイルが、XMLDIR
ディレクトリにある必要があります。
.Sp
目次などを提供するために、複数の \s-1XML\s0 ファイルを一つの book にまとめるのは一般的な手法です。book に \s-1XMLMAN3\s0
で指定したファイルも含む場合、book 自体ではなく、セクション 1 の \s-1XML\s0 ファイルだけをここに指定してください。book
にこのセクションの内容だけがある場合、book ファイルを指定してください。
.Sp
.Vb 2
\& # セクション 1 用 DocBook XML ファイル
\& XMLMAN1="po4a\-build.xml po4aman\-display\-po.xml po4apod\-display\-po.xml"
.Ve
.IP "\s-1XMLMAN3\s0" 4
.IX Item "XMLMAN3"
セクション 3 の manpage を生成するための DocBook \s-1XML\s0 です。ファイル名は空白で区切られます。すべてのファイルが、XMLDIR
ディレクトリにある必要があります。
.Sp
目次などを提供するために、複数の \s-1XML\s0 ファイルを一つの book にまとめるのは、一般的な手法です。book に \s-1XMLMAN1\s0
で指定したファイルも含む場合、book 自体ではなく、セクション 3 の \s-1XML\s0 ファイルだけをここに指定してください。book
にこのセクションの内容だけがある場合、book ファイルを指定してください。
.Sp
.Vb 2
\& # セクション 3 用 DocBook XML manpage
\& XMLMAN3=""
.Ve
.IP "\s-1XMLDIR\s0" 4
.IX Item "XMLDIR"
すべての DocBook \s-1XML\s0 ファイルの場所です。現在 \f(CW\*(C`po4a\-build\*(C'\fR は、このディレクトリにある *.xml ファイルを探すと
\&\s-1XMLMAN1\s0 と \s-1XMLMAN3\s0 に列挙したすべてのファイルが見つかることを期待しています。
.Sp
\&\s-1XMLMAN1\s0 や \s-1XMLMAN3\s0 を使用する場合、指定しなければなりません。設定ファイルの場所からの相対パスです。
.Sp
.Vb 2
\& # XML ファイルの場所
\& XMLDIR="share/doc/"
.Ve
.IP "\s-1XMLPACKAGES\s0" 4
.IX Item "XMLPACKAGES"
\&\s-1BINARIES\s0 のリスト外で、どのパッケージが \s-1XML\s0 ソース内容を使用するかを指定します。
.Sp
\&\s-1XMLMAN1\s0 や \s-1XMLMAN3\s0 で与えた値は、ここにも同様に与えなければなりません。
.Sp
.Vb 2
\& # DocBook XML & xsltproc を使用するバイナリパッケージ
\& XMLPACKAGES="po4a"
.Ve
.IP "\s-1DOCBOOKDIR\s0" 4
.IX Item "DOCBOOKDIR"
\&\s-1XMLDIR\s0 と同様ですが、翻訳された DocBook ファイルを準備するために使用します。パッケージで .sgml
ファイルを使用したい場合は、どのようにビルドするべきかを po4a\-devel メーリングリストで議論してください。
.Sp
.Vb 2
\& # .docbook ファイルを検索するパターン
\& DOCBOOKDIR=""
.Ve
.IP "\s-1XSLFILE\s0" 4
.IX Item "XSLFILE"
DocBook \s-1XML\s0 ファイルから翻訳済みおよび未訳の内容を用意するために使用される \s-1XSL\s0 スタイルシートです。
.Sp
.Vb 2
\& # DocBook XML に使用する XSL ファイル
\& XSLFILE="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
.Ve
.IP "\s-1PODFILE\s0" 4
.IX Item "PODFILE"
セクション 1 の manpage を生成するための \s-1POD\s0 ファイルです。POD
ファイルを空白で区切ります。使用する場合、設定ファイルの場所からの相対パスを指定する必要があります。
.Sp
.Vb 2
\& # セクション 1 用 POD ファイル
\& PODFILE="po4a po4a\-gettextize po4a\-normalize scripts/msguntypot"
.Ve
.IP "\s-1PODMODULES\s0" 4
.IX Item "PODMODULES"
\&\s-1POD\s0 内容を含む Perl モジュールに特化したサポートです。モジュール名はパスから再構築されます (そのため一般的な Perl
のレイアウトであるべきです)。また、manpage を自動的にセクション 3 に配置します。
.Sp
.Vb 2
\& # セクション 3 用 POD ファイル \- モジュール名はパスから再生成されます
\& PODMODULES="lib/Locale/Po4a/*.pm"
.Ve
.IP "\s-1POD5FILES\s0" 4
.IX Item "POD5FILES"
セクション 5 の manpage を生成する任意の \s-1POD\s0 内容です。使用する場合、設定ファイルの場所からの相対パスを指定する必要があります。
.Sp
セクション 5、7 の内容のファイル名の一部に 5 や 7 が含まれる場合は、(セクション 1
の内容でも使われるファイル名にしなければならない傾向があるので) ファイル名の拡張子と共に 5 や 7 が自動的に取り除かれます。
.Sp
.Vb 2
\& # セクション 5 用 POD ファイル
\& POD5FILES="doc/po4a\-build.conf.5.pod"
.Ve
.IP "\s-1POD7FILES\s0" 4
.IX Item "POD7FILES"
セクション 7 の manpage を生成する任意の \s-1POD\s0 内容です。使用する場合、設定ファイルの場所からの相対パスを指定する必要があります。
.Sp
セクション 5、7 の内容のファイル名の一部に 5 や 7 が含まれる場合は、(セクション 1
の内容でも使われるファイル名にしなければならない傾向があるので) ファイル名の拡張子と共に 5 や 7 が自動的に取り除かれます。
.Sp
.Vb 2
\& # セクション 7 用 POD
\& POD7FILES="doc/po4a.7.pod"
.Ve
.IP "\s-1PODPACKAGES\s0" 4
.IX Item "PODPACKAGES"
\&\s-1XMLPACKAGES\s0 と同様です。内容を \s-1POD\s0 ファイルからビルドするパッケージは、PODPACKAGES
に値が含まれている必要があります。PODFILE、PODMODULES、POD5FILES、POD7FILES に何か値を指定する場合必須です。
.Sp
.Vb 2
\& # POD を使用するバイナリパッケージ
\& PODPACKAGES="po4a"
.Ve
.IP "\s-1HTMLDIR\s0" 4
.IX Item "HTMLDIR"
未訳と翻訳済みの \s-1HTML\s0 出力を保存する \s-1BASEDIR\s0 のサブディレクトリです。
.Sp
.Vb 2
\& # HTML 出力 (BASEDIR のサブディレクトリ)
\& HTMLDIR=""
.Ve
.IP "\s-1HTMLFILE\s0" 4
.IX Item "HTMLFILE"
\&\s-1HTML\s0 に変換される DocBook ファイルです (\s-1XMLMAN1\s0 や \s-1XMLMAN3\s0 にあるファイルと同じかも)。セクションは \s-1HTML\s0
出力と関連がないので、HTML に目次などを作るため、気軽に単一 book ファイルを使用してください。
.Sp
.Vb 2
\& # HTML DocBook file
\& HTMLFILE=""
.Ve
.IP "\s-1HTMLXSL\s0" 4
.IX Item "HTMLXSL"
chunk \s-1XSL\s0 スタイルシートを使用する際のデフォルト値です。現在、HTML の実行ごとの、複数のスタイルシートの使用はサポートしていません。
.Sp
.Vb 2
\& # HTML に使用する XSL ファイル
\& HTMLXSL="http://docbook.sourceforge.net/release/xsl/current/html/chunk.xsl"
.Ve
.SH "著者"
.IX Header "著者"
.Vb 1
\& Neil Williams <linux@codehelp.co.uk>
.Ve
.SH "訳者"
.IX Header "訳者"
.Vb 2
\& 倉澤 望 <nabetaro@debian.or.jp>
\& Debian JP Documentation ML <debian\-doc@debian.or.jp>
.Ve