12.1. Úprava chování XSL stylů pomocí parametrů

Způsob jakým XSL styly formátují dokument lze ovlivňovat celou řadou parametrů. Kompletní přehled těchto parametrů lze nalézt v knize [Wal-02], kapitola Reference documentation.

Pro to, abychom mohli modifikovat parametry chování XSL stylu musíme nejprve vytvořit styl vlastní (uživatelský XSL styl). Ten do sebe naimportuje původní styl a předefinuje potřebné parametry. Při úpravách stylů pak využíváme toho, že naše deklarace mají přednost před těmi naimportovanými.

ikona
Příklad 12.1: Ukázka XSL stylu pro HTML
<?xml version='1.0' encoding='utf-8'?>
<xsl:stylesheet
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

<xsl:import href="file:///c:/docbook/xsl/html/chunk.xsl" />

<xsl:param name="callout.graphics" select="1"/>
<xsl:param name="base.dir" select="'output/'" />
<xsl:param name="html.stylesheet" select="'style.css'" />

<xsl:param name="chunk.section.depth" select="1"/>
<xsl:param name="chunk.first.sections" select="1"/>
<xsl:param name="generate.component.toc" select="1"/>
<xsl:param name="toc.section.depth">2</xsl:param>

<xsl:param name="section.autolabel" select="1"/>
<xsl:param name="section.label.includes.component.label" select="1"/>
<xsl:param name="generate.chapter.toc" select="1"/>

Jak vidíme, na pátém řádku se importuje konkrétní styl který předefinováváme. V tomto případě je to styl pro generování děleného HTML (chunk). Styl importujeme buď přímo cestou k souboru, kde se v systému nalézá (pomocí file:///), pokud nám správně fungují XML katalogové soubory, uvedeme sem URL adresu. Záleží jen na nás, jaký způsob využijeme - druhý je pracnější, ale přenositelnější.

Pod importem XSL jsou pak uvedeny parametry, měnící chování vloženého stylu. Máme jich k dispozici opravdu mnoho, takže je nebudeme podrobněji rozebírat. Jen poznamenáme, že uvedené parametry mimo jiné zapínají generování obrázků do výpisu kódů callout, nastavují adresář pro generování HTML, definují název CSS souboru a ovlivňují způsob generování HTML souborů (hloubku generovaných sekcí a způsob generování obsahu).

Při volání XSLT procesoru pro generování výsledného formátu mu pak samozřejmě předáváme náš styl, který zajistí zavolání stylu standardního a změnu jeho parametrů.

Vlastní styly zpravidla vytváříme dvojí - jeden pro generování HTML a jeden pro generování PDF (ten se zase upravuje parametry pro generování FO, jež jsou uvedeny ve stejné dokumentaci).

ikona
Důležité:

Používejte uživatelské styly! Umožní vám snadno vkládat standardní XSL styly s tím že můžete ihned nastavovat jejich parametry. V dávkových souborech pak vždy zavoláte jen příslušný uživatelský XSL soubor, což výrazně usnadňuje a zpřehledňuje práci.

S úpravou pomocí parametrů souvisí i chování pomocí procesních instrukcí o kterých jsme se již zmiňovali.