Docbookのソースを表示

[[Category:ファイルフォーマット]]
[[en:Docbook]]
[[Wikipedia:ja:DocBook|DocBook]] は技術文書を作成するためのマークアップ言語です。

== インストール ==

{{Pkg|docbook-xml}} と {{Pkg|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''

== 自動化 ==

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

{{bc|1=
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"
}}

== トラブルシューティング ==

=== コンパイルエラー ===

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

{{bc|
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
}}

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