DocBookで日本語の文書を作る


目次

1. 図と表
2. 箇条書き
丸付き
番号付き
定義型
索引

図目次

1.1. ツールチェイン

表目次

1.1. 主なツール

第1章 図と表

DocBook形式で日本語の文書を作る実験をしました。

最初は図です。GIFのファイルを読み込んでみます。

図1.1 ツールチェイン

ツールチェイン

続いて表です。表を書くタグはDocBook由来のものとHTMLに近いものとあります。ここではDocBook由来のものを使ってみます。

表1.1 主なツール

製品名種類説明
xsltprocXSLT

UNIX環境で利用できるC言語のXSLTプロセッサ。WindowsでもCygin環境で利用できる。

SaxonXSLT

Javaで書かれたXSLTプロセッサ

Apache XalanXSLT

Javaで書かれたXSLTプロセッサ

Apache FOPXSL-FO

Javaで書かれたFOプロセッサ。

DocBook XSLXSL

DocBook XMLを各種出力形式に変換するXSL集。

WYSIWYGdocbookCSS

DocBook用CSS(Cascading Stylesheet)。プロセッサで変換せずにブラウザで直接プレビューできるので便利。


第2章 箇条書き

章を改めて、次は箇条書きを作ってみます。箇条書きの種類ごとに節に分けてみます。

丸付き

まずは丸付きの箇条書き(itemizedlist)です

DocBook XSLで作成できる文書形式を列挙します。

  • HTML
  • XHTML
  • Windows Help (HtmlHelp)
  • FO(PDFを作るもとになる)
  • WordML(Microsoft WordのXML形式)
  • ...

このうち筆者はApache Xalan/FOPを用いて、HTML、PDF、HtmlHelpを試してみました。

番号付き

番号付きの箇条書き(orderedlist)の例として、DocBook XSLでWindows Help(HtmlHelp)を作る手順です。

  1. DocBook原稿を書く。大半をテキストエディタで書いたあと、XMLMind XML Editorで確認、整形、その後すこし手を入れる、という手順を取った。

  2. Apache FOPに含まれているXalan XSLTプロセッサで、HtmlHelpのプロジェクトソースを生成。

  3. Xalanの出力はそのままでは日本語が文字化けしたり検索が通らなかったりするので、横浜工文社製一括置換プログラム、Text Cookerで修正。

  4. HtmlHelp WorkshopでコンパイルしてCHMファイルを生成。これで、日本語が正しく表示され、日本語の検索もできるヘルプができあがった。

定義型

HTMLの<DL>にあたる用語とその定義を表す形式の箇条書きです。

XSL (eXtended Stylesheet Language)

XML文書を変換したり、表示や印刷ができるよう整形するための、W3Cの勧告。

XSL = XSLT + XSL-FO

XSLT (XSL Transformation)

XML文書の変換方法を書いたXML文書。変換先はXMLやHTMLやテキスト、そして次のFOなど。

XSL-FO (XSL Formatting Objects)

XML形式の組版命令。Apache FOPでFOをPDFに変換できる。

索引

シンボル

箇条書き, 丸付き
図, 図と表
表, 図と表
文字化け, 番号付き

W

WordML, 丸付き
WYSIWYGdocbook, 図と表

X

XMLMind, 番号付き