Obsah
V úvodní kapitole 2 – „První kroky“ jsme se seznámili s tím, jak z DocBooku generovat nejběžnější výstupní formáty pomocí DSSSL a XSL stylů. V této kapitole se podíváme na další metody a výstupní formáty, které lze společně s DocBookem použít. Celý text přitom bude rozčleněn podle výstupního formátu. Snadno tak zjistíte, jaké jsou alternativní možnosti pro získání požadovaného výstupu. Už z principu nemůže být seznam kompletní, a přidání podpory dalšího výstupního formátu je celkem snadné, protože XML dokumenty lze velmi snadno zpracovávat a dále konvertovat.
jade -d c:\docbook\dsssl\html\docbook.dsl -t sgml c:\docbook\jade\xml.dcl dokument.xmljade -d c:\docbook\dsssl\html\docbook.dsl -V nochunks -t sgml c:\docbook\jade\xml.dcldokument.xml>dokument.html
Výstup do RTF:
jade -d c:\docbook\dsssl\print\docbook.dsl -t rtf c:\docbook\jade\xml.dcl dokument.xmlRTF lze přímo načíst do většiny textových editorů. Chceme-li získat PDF, můžeme RTF dokument zpracovat pomocí textového editoru (např. MS Word) a Adobe Distilleru (nebo jeho funkční obdoby).
PDF a PS výstup lze snadno získat i pomocí výstupu do TeXu. Musíme mít nainstalovanou poměrně novou verzi TeXu s formátem JadeTeX. Poslední verze JadeTeXu je k dispozici na adrese http://jadetex.sourceforge.net/.
jade -d c:\docbook\dsssl\print\docbook.dsl -t tex -V tex-backend c:\docbook\jade\xml.dcldokument.xmlpdfjadetexdokumentpdfjadetexdokumentpdfjadetexdokument
Pro vygenerování PostScriptové verze můžeme použít příkazy:
jade -d c:\docbook\dsssl\print\docbook.dsl -t tex -V tex-backend c:\docbook\jade\xml.dcldokument.xmljadetexdokumentjadetexdokumentjadetexdokumentdvipsdokument
JadeTeX musíme spustit třikrát, aby se správně spočítala čísla stran v obsahu a v křížových odkazech.
V první fázi musíme získat formátovací objekty:
saxon -odokument.fodokument.xmlc:\docbook\xsl\fo\docbook.xsl
nebo
xsltproc -odokument.foc:/docbook/xsl/fo/docbook.xsldokument.xml
Výsledné formátovací objekty pak musíme zpracovat některým z procesorů FO.
xep -fodokument.fo-pdfdokument.pdf
xep -fo dokument.foNebo jednorázově včetně transformace:
xep -xml dokument.xml -xsl c:/docbook/xsl/fo/docbook.xslPassiveTeX je procesor FO postavený nad TeXem. Pro jeho činnost je potřeba moderní instalace TeXu. Aktuální verze PassiveTeXu je dostupná na adrese http://www.tei-c.org/Software/passivetex/.
Pro získání PDF z FO pak stačí použít příkaz:
pdfxmltex dokument.foPokud chceme, aby nám seděla čísla stran v obsahu, musíme poslední příkaz spustit dvakrát po sobě.
PostScript získáme obdobně. Nejprve si vygenerujeme formátovací objekty a pak spustíme příkazy:
xmltexdokument.foxmltexdokument.fodvipsdokument
Program XFC umožňuje formátovací objekty konvertovat do formátů RTF, WordML a ODF.
fo2rtfdokument.fodokument.rtf
fo2wmldokument.fodokument.xml
fo2odtdokument.fodokument.odt
Kromě toho obsahuje příjemné grafické prostředí XSL Utility, pro snadné spouštění transformací DocBooku do dalších formátů.
Na adrese http://db2latex.sourceforge.net/ je k dispozici sada XSL stylů, které jsou schopné převést docbookový dokument na LaTeX. Umíte-li LaTeX je to celkem dobrá cesta, jak získat typograficky mnohem dokonalejší dokument než z klasických DSSSL nebo XSL stylů. Styly potřebují většinou drobně upravit – jednak proto, abyste s nimi mohli zpracovat české dokumenty, a také proto, aby výstup odpovídal přesně vašim potřebám.
Pro generování HTML Helpu musíme mít HTML Help Workshop – http://msdn.microsoft.com/library/tools/htmlhelp/chm/HH1Start.htm.
saxondokument.xmlc:\docbook\xsl\htmlhelp\htmlhelp.xsl "htmlhelp.encoding=windows-1250" "chunker.output.encoding=windows-1250" "saxon.character.representation=native" hhchtmlhelp.hhp
Pro prohlížení JavaHelpu musíte mít k dispozici JavaHelp – http://java.sun.com/products/javahelp/.
saxon dokument.xml c:\docbook\xsl\javahelp\javahelp.xsl "javahelp.encoding=windows-1250" "chunker.output.encoding=windows-1250" "saxon.character.representation=native"
jhindexer *.html
jar -cvf help.jar *
hsviewer jhelpset.hs help.jarEclipse je open-source vývojové prostředí.
saxon dokument.xml c:\docbook\xsl\eclipse\eclipse.xsl "eclipse.plugin.id=com.example.help"Vygenerované soubory pak stačí nahrát do adresáře
com.example.help (nebo jiného v závislosti na
nastavení parametru) v adresáři plugins
a restartovat Eclipse.
Projekt docbook2X – http://docbook2x.sourceforge.net/.
Manuálové stránky umí generovat i novější verze standardních XSL stylů.