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.
V našem instalačním balíku je vše potřebné
samozřejmě tak jako vždy připraveno a to konkrétně v adresáři
C:\DocBook\website\
.
V adresáři C:\DocBook\website\my_xsl\
naleznete
uživatelské XSL styly, které se používají při překladu a slouží pro upravování parametrů. V
adresáři C:\DocBook\website\my_example\
máte připravené
ukázkové webové sídlo. Ostatní adresáře pochází přímo z balíku DocBook
website.