Ukážeme si podrobně zprovoznění website v rámci našeho předchozího instalačního postupu.

DTD a XSL pro tvorbu webových stránek pomocí DocBooku opět připravil Norman Walsh a získáme je z internetové adresy http://docbook.sourceforge.net.

Ze stránek http://sourceforge.net/projects/docbook si stáhneme archiv website-2.5.0.zip, ve kterém se jako obvykle nachází jeden adresář. Obsah tohoto adresáře rozbalíme do C:\DocBook\website\.

Dále budeme potřebovat starší DocBook DTD v4.2, protože s novější verzí website nefunguje správně. Ten získáme z http://www.docbook.org/xml/4.2/index.html a rozbalíme do C:\DocBook\website\dtd.

Také musíme doplnit website do XML katalogu. Bohužel pouhé přidání website katalogu do toho současného DocBookem v4.3 není možné, neboť pak nefunguje generování HTML formátu. Musíme proto pro website vytvořit samostatný XML katalogy.

To nejlépe provedeme tak že do adresáře C:\DocBook\website\resolver\ umístíme knihovnu resolver.jar a vytvoříme zde soubor CatalogManager.properties s tímto obsahem:

#CatalogManager.properties

verbosity=1

# Always use semicolons in this list
catalogs=file:///c:/docbook/website/my_xsl/catalog.xml;

prefer=public

catalog-class-name=org.apache.xml.resolver.Resolver

Dále vytvoříme adresář C:\DocBook\website\my_xsl\, do kterého umístíme XMl katalog catalog.xml.

<?xml version='1.0'?>
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog" prefer="public">

<nextCatalog catalog="../dtd/catalog.xml" />
<nextCatalog catalog="../catalog.xml" />
<nextCatalog catalog="../../xsl/catalog.xml" />

</catalog>

Dále vytvoříme uživatelský XSL styl, tak jak je naším zvykem - my_website.xsl. Jeho obsah můžete vidět v příkladu 13.3.

Nakonec je potřeba opravit chybu v distribuci website 2.5.0, díky které nelze správně generovat výstupní formát. Oprava spočívá v tom, že otevřeme soubor xsl/autolayout.xsl a změníme v něm číslo verze z 2.4.1 na 2.4.0 - vyskytuje se tam dvakrát.