DocBook

DocBook

  1. Stáhněte si ukázkové dokumenty a rozbalte si je do nějakého adresáře.

  2. Zběžně si prostudujte velmi jednoduchý ukázkový dokument prvni.xml.

  3. Konverze DocBooku do dalších formátů. Nejčastěji se pro konverzi používají XSL styly. Zkuste si dokument převést do následujících formátů:

    jedna HTML stránka
    saxon -o prvni.html prvni.xml y:\w32\xml\ss\xsl\html\docbook.xsl
    sada HTML stránek
    saxon prvni.xml y:\w32\xml\ss\xsl\html\chunk.xsl
    PDF
    saxon -o prvni.fo prvni.xml y:\w32\xml\ss\xsl\fo\docbook.xsl
    xep -fo prvni.fo

    nebo kratším způsobem:

    xep -xml prvni.xml -xsl y:\w32\xml\ss\xsl\fo\docbook.xsl
    nápověda ve formátu HTML Help
    saxon prvni.xml y:\w32\xml\ss\xsl\htmlhelp\htmlhelp.xsl "htmlhelp.encoding=windows-1250"

    Následně se vygenerované soubory přeloží pomocí programu HTML Help Workshop (program je na školní síti dostupný pomocí Application Exploreru).

  4. Zkuste si do ukázkového dokumentu vložit jednoduché struktury jako seznamy, obrázky a tabulky v nějakém textově orientovaném editoru XML jako je oXygen. Po úpravách si dokument zvalidujte, ať máte jistotu, že neobsahuje chyby a zkuste si jej znovu převést do některého z výstupních formátů.

    Pro převod můžete použít připravené dávkové soubory, které zavolají XSLT, případně i FO procesor s odpovídajícími parametry.

    db2html dokument.xml
    db2rtf dokument.xml
    db2chunk dokument.xml
    db2fo dokument.xml
    db2pdf dokument.xml
  5. Vyzkoušejte si editaci dokumentu ve vizuálním editoru XML Mind. Spustíte jej pomocí příkazu xxe.

  6. Zbude-li vám čas, zkuste si vytvořit vlastní styl, který upraví některé parametry standardních docbookových stylů.

    Kostra stylu:

    <?xml version="1.0" encoding="windows-1250"?>
    <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                    version="1.0">
    
    <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
    
    <!-- Úpravy parametrů -->
    
    </xsl:stylesheet>

    Popis parametrů naleznete na adrese http://docbook.sourceforge.net/release/xsl/current/doc/html/index.html