Docbook

DocBook は技術文書を作成するためのマークアップ言語です。

インストール

docbook-xml と docbook-xsl パッケージをインストールしてください。

XML ファイルの検証

XML ファイルを検証するには:

$ xmllint --valid --noout /path/to/file.xml

ファイルが XML として正しければ何も出力がされません。

XHTML に変換

シングルファイル

XHTML ファイル (シングルファイル) に変換するには:

$ xsltproc /usr/share/xml/docbook/$(pacman -Q docbook-xsl | cut -d ' ' -f 2 | cut -d '-' -f 1)/xhtml/docbook.xsl /path/to/file.xml > output.html

セグメントファイル

分割 XHTML ファイル (セクションごとにひとつのファイル) に変換するには:

$ xsltproc /usr/share/xml/docbook/$(pacman -Q docbook-xsl | cut -d ' ' -f 2 | cut -d '-' -f 1)/xhtml/chunk.xsl /path/to/file.xml

自動化

~/.bashrc (あるいは別のシェルのスタートアップファイル) に以下を追加:

alias doc2html1="xsltproc /usr/share/xml/docbook/xhtml/docbook.xsl"
alias doc2multihtml="xsltproc /usr/share/xml/docbook/xhtml/chunk.xsl"
alias docvalidate="xmllint --valid --noout"

トラブルシューティング

コンパイルエラー

上記のパッケージをインストールしているのに、以下のようなコンパイルエラーが表示される場合:

GEN    appdata-validate.1
I/O error : Attempt to load network entity http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl
warning: failed to load external entity "http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"
cannot parse http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl

docbook-xml と docbook-xsl を再インストールしてください。カタログファイルが破損している場合、xmlcatalog を実行して /etc/xml/catalog を再ビルドすることで、コンパイルエラーが解決することがあります。