ツールセット

PostgreSQL 8.0.0 文書
前のページ | 巻戻し | 付録 G. Documentation | 早送り | 次のページ

# G.2. ツールセット

ドキュメントを処理する過程で次のようなツールが使われます。 その内のいくつかは付記されているように省略可能です。

DocBook DTD

  DocBookそのものの定義です。 現在は4.2バージョンを使用していて、これより古いまたは新しいバージョンは使用できません。 またXMLバージョンのDocBookもありますが、使わないでください。

ISO 8879 character entities

  DocBookに必要なものですが、ISOでメンテナンスされているため別に配布されています。

OpenJade

  SGMLを処理する基本パッケージです。 パッケージにはSGMLパーサ、（DSSSLスタイルシートを使用してSGMLを他のフォーマットに変換するプログラムである）DSSSL プロセッサ、および数多くの関連ツールが含まれています。 Jadeは現在James ClarkではなくOpenJadeグループがメンテナンスしています。

DocBook DSSSL Stylesheets

  DocBookのソースをHTMLのような他のフォーマットに変換する処理手順が含まれています。

DocBook2X tools

  マニュアルページを作成するために使用される、オプションのパッケージです。 このパッケージ自身が必要とするパッケージがいくつかあります。 Webサイトで確認してください。

JadeTeX

  お望みならばJadeTeXをインストールしてJadeをフォーマットするバックエンドとしてTeXを使うこともできます。 JadeTeXによるとPostscriptまたは（ブックマーク付の）PDFファイルが作成できます。

  とはいっても、JadeTeXでの出力はRTFバックエンドで得られる結果よりも品質が劣ります。 特に問題があるのは表と水平垂直方向のスペーシングに関係する多彩な細工に関わる部分です。 更に、でき上がった結果を手作業で修正することもできません。

ドキュメントを作成するために必要な様々なツールのインストール方法についての経験をまとめました。 以下に記載します。 これらのツールは別にパッケージ化されて配布されていることも考えられます。 もしそのような配布物を見つけた場合はdocのメーリングリストに報告してください。 そのような情報をここに付け加えたいと思います。

## G.2.1. Linux RPM のインストール

数多くのベンダーがディストリビューションの中にDocBook処理用のRPMパッケージ一式を提供しています。 インストールに際しては"SGML"オプションまたは`sgml-common`、`docbook`、`stylesheets`、`openjade`（あるいは`jade`）パッケージがあるか確認してください。 `sgml-tools`も必要かもしれません。 お手持ちのディストリビューションで提供されていない時は、その他の互換性のある配布元のパッケージを利用できるはずです。

## G.2.2. FreeBSD のインストール

FreeBSDのドキュメントプロジェクトそのものがDocBookのヘビーユーザですから、FreeBSD上で使用できるドキュメント作成用ツールの"port"一式が揃っていることは驚くにあたりません。 FreeBSD上でドキュメントをビルドするには以下のportsが必要です。

- `textproc/sp`

- `textproc/openjade`

- `textproc/iso8879`

- `textproc/dsssl-docbook-modular`

今のところDocBook V4.2 SGML DTD用のportsは無いようです。 手作業でインストールする必要があるでしょう。

`/usr/ports/print`（`tex`、`jadetex`）の中にも興味を引くものが数多くあります。

portは`/usr/local/share/sgml/catalog`にあるメインカタログファイルを更新しない可能性があります。

    CATALOG "/usr/local/share/sgml/docbook/4.2/docbook.cat"

という行があることを確認してください。 もしもファイルを編集したくない場合は`SGML_CATALOG_FILES`環境変数をカタログファイルにコロンで分割して（上記のように）設定することもできます。

FreeBSDでのドキュメント作成ツールについての更に詳しい情報はFreeBSD Documentation Project's instructionsにあります。

## G.2.3. Debian パッケージ

Debian GNU/Linux用のドキュメント作成パッケージの一式が揃っています。 インストールには以下を使います。

    apt-get install jade
    apt-get install docbook
    apt-get install docbook-stylesheets

## G.2.4. ソースから手作業でインストール

DocBookツールを手作業でインストールするのは何かと複雑ですからもし既にできているパッケージがあるならばそちらを使ったほうがよいでしょう。 ここでは標準的なインストール手順として一般的な機能以外を持たせない標準的なセットアップのみを説明します。 詳しいことはそれぞれにパッケージのドキュメントとSGMLの入門資料を読んでください。

### G.2.4.1. OpenJade のインストール

1. OpenJadeのインストールはGNU形式の`./configure; make; make install`ビルド手順で行います。 詳しいことは OpenJade ソース配布物の中にあります。 要約すると次のようになります。

       ./configure --enable-default-catalog=/usr/local/share/sgml/catalog
       make
       make install

   "デフォルトカタログ"をどこに置いたか覚えておいてください。 後で必要になります。 そのままにしておいても構いませんが、後でjadeを使用する時には`SGML_CATALOG_FILES`環境変数を設定してファイルの場所を指定する必要があります。 （既にOpenJadeがインストールされていて残りのツール一式を別の場所にインストールしたい場合にはこの方法を使用する手があります。）

2. 更に`dsssl`ディレクトリからどこか、例えば`/usr/local/share/sgml/dsssl`といったディレクトリに`dsssl.dtd`、`fot.dtd`、`style-sheet.dtd`および`catalog`をインストールします。 ディレクトリ全てを一括コピーすることが一番簡単です。

       cp -R dsssl /usr/local/share/sgml

3. 最後に、`/usr/local/share/sgml/catalog`ファイルを作成して以下の行を付け加えます。

       CATALOG "dsssl/catalog"

   （これはステップ2 にインストールされたファイルへの相対的参照パスです。 インストール先のレイアウトを変更している場合にはそれに合わせる必要があります。）

### G.2.4.2. DocBook DTD キットのインストール

1. DocBook V4.2 を入手します。

2. `/usr/local/share/sgml/docbook-4.2`ディレクトリを作成してそこに移動します。 （正確にこの場所でなくても構いませんが、ここで説明して行く流れの中では筋が通っているものです。）

       $ mkdir /usr/local/share/sgml/docbook-4.2
       $ cd /usr/local/share/sgml/docbook-4.2

3. アーカイブを解凍します。

       $ unzip -a ...../docbook-4.2.zip

   （アーカイブは置かれた場所に解凍されます。）

4. `/usr/local/share/sgml/catalog`ファイル（もしくはインストール時にjadeに指定したファイルに）に以下の一行を付け加える編集を行います。

       CATALOG "docbook-4.2/docbook.cat"

5. ISO 8879 character entitiesアーカイブをダウンロードし、解凍してできたファイルをDocBookのファイルと同じディレクトリに置きます。

       $ cd /usr/local/share/sgml/docbook-4.2
       $ unzip ...../ISOEnts.zip

6. DocBookとISOファイルを置いたディレクトリで以下のコマンドを実行します。

       perl -pi -e 's/iso-(.*).gml/ISO\1/g' docbook.cat

   （この操作によってDocBookカタログファイルで使われる名称と実際のISO文字登録ファイル間での重複が整理されます。）

### G.2.4.3. DocBook DSSSL スタイルシートのインストール

スタイルシートのインストールは配布物を解凍して例えば `/usr/local/share/sgml` のような適当な場所に置きます。 （アーカイブは自動的にサブディレクトリを作成します。）

    $ gunzip docbook-dsssl-1.xx.tar.gz
    $ tar -C /usr/local/share/sgml -xf docbook-dsssl-1.xx.tar

`/usr/local/share/sgml/catalog` にある通常のカタログエントリも作成されます。

    CATALOG "docbook-dsssl-1.xx/catalog

スタイルシートは頻繁に変更されたり、他に使えるバージョンを試してみることは有益ですから、PostgreSQLはこのカタログエントリを使用しません。 どのようにスタイルシートを選択するかについての情報は項G.2.5を参照してください。

### G.2.4.4. JadeTeX のインストール

JadeTeXをインストールし使用するにはtoolsとgraphicsパッケージBabel、AMSフォントおよびAMS-LaTeX、PSNFSS拡張と"the 35 fonts"の付属キット、PostScriptを生成するdvipsプログラム、マクロのパッケージとしてfancyhdr、hyperref、minitoc、urlおよびot2encがサポートされているTeXとLaTeX2eが既にインストールされていなくてはなりません。 これら全ては、好意的な仲間でもあるCTANサイトにあります。 TeXの基本システムのインストールはこの紹介文の範囲をはるかに越えています。 どのようなシステム上でも稼働するTeXのバイナリパッケージはいずれかに存在します。

JadeTeXをPostgreSQLのドキュメントソースに適用する前にTeX内部データ構造の容量を増やさないといけない場合があります。 この件に関しての詳細はJadeTeXのインストールの説明のところに記載されています。

この操作を終えたところで JadeTeX をインストールできるようになります。

    $ gunzip jadetex-xxx.tar.gz
    $ tar xf jadetex-xxx.tar
    $ cd jadetex
    $ make install
    $ mktexlsr

最後の二つの入力は root になって行います。

## G.2.5. `configure` の書き方

PostgreSQL本体のプログラムを構築した時のように、ドキュメントを構築する時に`configure`スクリプトを実行する必要があります。 実行が終わる近辺の次のような出力を確認してください。

    checking for onsgmls... onsgmls
    checking for openjade... openjade
    checking for DocBook V4.2... yes
    checking for DocBook stylesheets... /usr/lib/sgml/stylesheets/nwalsh-modular
    checking for sgmlspl... sgmlspl

もしも`onsgmls`あるいは`nsgmls`が見つからなかった場合には残り4行は表示されません。 `nsgmls`はJadeパッケージの一部です。 "DocBook V4.2"が見つからない場合はDocBook DTDキットをjadeが見つけられない場所に置いたか、もしくはカタログファイルが正しく設定されていません。 前述のインストレーションのヒントを見てください。 DocBookスタイルシートはいくつか比較的標準となっている場所から探されますので、別の場所に置いた時には`DOCBOOKSTYLE`環境変数でその場所を設定してから`configure`を後で再実行します。

前のページ | ホーム | 次のページ
Documentation | 上に戻る | ドキュメントのビルド