DocBook XMLに関するメモ

オンラインマニュアルの作成にDocBook XMLを使用しています。

DocBook XMLを別の形式に変換する

!DocBookに限った話ではないのですが、XMLファイルを別の形式に変換する場合、xsltprocコマンドを利用します。その基本構文は次の通りです。

$ xsltproc オプション スタイルシート XMLファイル

!DocBook用のスタイルシートは、/usr/share/sgml/docbook/xsl-stylesheets以下に用意されています。以下、HTMLファイルに変換する例を記述します。

単一のHTMLファイルに出力する

$ xsltproc /usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl source.xml > dest.html

スタイルシートに/usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xslを使用した場合、標準出力にHTMLを吐き出しますのでリダイレクトしています。

複数のHTMLファイルに分割する

$ xsltproc /usr/share/sgml/docbook/xsl-stylesheets/html/chunk.xsl source.xml

ファイル名は、分割される単位の章(chapter)や節(sect)に指定したidを元にします。idが指定されていない場合、自動でファイル名が決定されます。

スタイルシートパラメータを使用する

xsltprocのオプション --stringparam を使うとスタイルシートパラメータを指定する事ができます。

例:出力エンコーディングをeuc-jpにする

--stringparam chunker.output.encoding euc-jp

例:出力を整形する

--stringparam chunker.output.indent yes

外部リンク

•  DocBook: The Definitive Guide
•  DocBook XSL: The Complete Guide