III.2. XSLTファイルの作成

III.2. XSLTファイルの作成
	第III章 DocBook文書から単一のHTMLを作成する

DocBook文書から単一のHTMLファイルへ変換するスタイルシートの作成を行います。

			
hello-html.xsl
			
<?xml version="1.0"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                version='1.0'>
  <xsl:import href="../docbook-xsl-1.70.1/html/docbook.xsl"/>
  <xsl:output method="html" encoding="UTF-8" indent="yes" />

  <xsl:param name="admon.graphics" select="1"/>
  <xsl:param name="section.autolabel" select="1"/>
  <xsl:param name="html.stylesheet">css/hello-html.css</xsl:param>
</xsl:stylesheet>

XSLタグの説明を以下に記述します。

表 III.1. docbook-xslタグの説明

タグ説明

xsl:import

単一のHTML変換用のスタイルシート /docbook-xsl-1.70.1/html/docbook.xsl を読み込んで変数などの変更を行います。

	注意
	直接そのファイルに変更を行うことはしないようにします。

xsl:output

method で html を指定してHTMLファイルを出力させます。 xhtmlを出力させたい場合は xml とします。 encoding で出力するときの文字コードを指定します。ここでは UTF-8 を指定しています。 indent を yes と指定することにより、字下げをして出力されます。

画像ファイルをどこに？とか、画像の種類の指定方法は /docbook-xsl-1.70.1/html/param.xsl を見るとデフォルト値の記述があります。いくつかピックアップして説明していきます。

表 III.2. DocBook-XSLで使用しているパラメータの設定

パラメータ名	説明
`admon.graphics`	注釈や、警告などの表示にアイコン画像を使用するか否かを指定します。デフォルトはアイコン画像を指定しないようになっています。
`admon.graphics.path`	画像の参照先のフォルダを指定します。デフォルトは `images/` ですのでそのままで良いでしょう。
`admon.graphics`	アイコン画像を使用するか／使用しないかを設定します。アイコン画像を指定する際は上図のように `select="1"` と指定します。
`callout.graphics.extension`	画像ファイルの拡張子を指定します。デフォルトは `.png` になっています。
`section.autolabel`	章に番号を付けるかどうかを指定します。 `capter.autolabel`も同様です。 `select="1"` の場合／または `select="arabic"` と指定した場合数字で附番されます。 (1, 2, 3 ...).デフォルトはこの指定方法になっています。 `select="A"` の場合／または `select="upperalpha"` と指定した場合大文字のアルファベットで附番されます。例 (A, B, C ...). `select="a"` の場合／または `select="loweralpha"` とした場合小文字のアルファベットで附番されます。例 (a, b, c ...). `select="I"` の場合／または、 `select="upperroman"` とした場合大文字のローマ数字で附番されます。例(I, II, III ...). `select="i"` の場合／または、 `select="lowerroman"` とした場合小文字のローマ数字で附番されます。例 (i, ii, iii ...).
`html.stylesheet`	出力ファイルが参照するCSSのファイルを指定します。


第III章 DocBook文書から単一のHTMLを作成する		III.3. CSSファイルの作成

Menu

III.2. XSLTファイルの作成