Michael Wiedmann

mw@miwie.in-berlin.de

Version 0.1.17 [2004-08-23] Copyright (c) 2003, 2004 Michael Wiedmann Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. DB2&latex; ist eine Sammlung von XSL Stylesheets, die DocBook XML Quelldateien mit Hilfe eines XSLT Prozessors nach &latex; wandeln und somit die Erzeugung von hochwertigem PDF als Ausgabeformat ermöglicht. Dieses Projekt hat in der Zwischenzeit einen Stand erreicht, der es meiner Meinung nach mit nur wenig Anpassungsaufwand auch für Einsteiger benutzbar macht. Dieses Mini-HOWTO soll den Einstieg zur Benutzung von DB2&latex; erleichtern. Zuerst die wichtigsten Informations-Quellen aus erster Hand: Projekt Overview http://db2latex.sourceforge.net/whatis.html Quickstart http://db2latex.sourceforge.net/quickstart.html Reference http://db2latex.sourceforge.net/reference/ Zu beachten ist, dass die Online-Doku deutlich hinter der Implementierung hinterherhinkt. Vor allem bei der Reference ist dies wichtig, da erst ein Blick in die Quellen (oder Nachfrage bei den Maintainern oder mir) klären kann, ob ein bestimmtes Feature bzw. Markup Tag bereits implementiert ist. DB2&latex; Die XSL Stylesheets stehen unter http://sourceforge.net/project/showfiles.php?group_id=22450&release_id=152929 als Source zur Verfügung. Die z.Z. aktuelle offizielle Version 0.8pre1 stammt vom 30. Januar 2004. Aufgrund der raschen Weiterentwicklung in den letzten Wochen empfehle ich jedoch gleich die CVS Version (http://sourceforge.net/cvs/?group_id=22450), das täglich erstellte Snapshot Debian Paket (http://db2latex.sourceforge.net/debian/binary-all/nightly/) oder das tar.gz Archiv (http://db2latex.sourceforge.net/snapshot/) zu benutzen. Seit kurzem gibt es ein offizielles Debian Paket in testing/unstable: http://packages.debian.org/db2latex-xsl XSLT Prozessor Als XSLT Prozessor eignet sich prinzipiell jeder, da an ihn keine besonderen Anforderungen gestellt werden. Im Folgenden (besonders in den Template-Dateien) wird von xsltproc (aus dem gleichnamigen Debian Paket) ausgegangen. &latex; Ein ausreichend aktuelles &latex; wird vorausgesetzt. Dazu eignet sich entweder eine Installation der aktuellen TeXLive 09/2003 bzw. ein tetex in einer neueren Version >= 2.0.x. Debian Woody Benutzer sollten unbedingt ein Update auf ein neueres tetex durchführen (Backports für Woody: http://www.kuesterei.ch bzw. http://mirrors.backports.org). Durch Anwenden des XSL Stylesheets (entweder unverändert docbook.xsl aus den DB2&latex; XSL Stylesheets, dann aber ohne jede Anpassung) bzw. eines eigenen Customization XSL Stylesheets (das die Datei docbook.xsl aus den DB2&latex; XSL Stylesheets importiert) mit Hilfe eines XSLT-Prozessors wird als Zwischenformat eine TeX-Datei erzeugt, aus der dann mit Hilfe von pdflatex PDF bzw. mit latex DVI und dvips PS erzeugt wird.

Das folgende Template stellt das Minimal-Beispiel für die Customization der XSL Stylesheets dar. Ab Zeile 9 sind die eigentlichen Anpassungen einzutragen. Hierzu hilft ein Blick auf http://db2latex.sf.net/reference/ bzw. in die Datei /usr/share/sgml/docbook/stylesheet/xsl/db2latex/latex/vars.mod.xsl. ]]> Das folgende Beispiel einer ausführlichen Custom XSL Datei wird vorerst lediglich unkommentiert eingefügt. Ggf. erfolgt demnächst eine ausführliche Beschreibung einzelner Abschnitte. scrbook]]> In diesem Beispiel wird als &latex; Dokumentenklasse scrbook (Zeile 9) aus den aktuellen KOMA-Klassen benutzt. Diese sind wegen ihrer umfangreichen Konfigurierbarkeit hervorragend geeignet. cleardoubleplain,smallheadings backref,breaklinks 0]]> Wir brauchen keine &latex; Math Unterstützung und setzen den entsprechenden Parameter auf 0 (Zeile 14). Andernfalls wird zusätzlicher &tex; Code erzeugt. ngerman 1 0 pdfauthor={Vorname Nachname}, pdfpagemode=UseNone, pdftitle={Interessanter Title}, pdfsubject={Untertitel} ]]> Die PDF Document Properties (Ctrl-D in Acrobat Reader) werden in Zeilen 24&vonbis;26 gesetzt. Weitere Optionen sind in der Dokumentation zu hyperref zu finden. 1 1 1 0 0 %% T1 encoding \usepackage[T1]{fontenc} %% support for landscape pages \usepackage{lscape} %% %% %% hyphenation settings \setlength\emergencystretch{3em} \hyphenpenalty=1000 \AtBeginDocument{\lefthyphenmin=3\righthyphenmin=3} ]]> Die Zeilen 48&vonbis;50 enthalten &tex; Code, der die Silbentrennung beeinflusst. %% more space for floats \renewcommand{\textfraction}{0.05}% \renewcommand{\topfraction}{0.95}% \renewcommand{\bottomfraction}{0.95}% \renewcommand{\floatpagefraction}{0.35}% ]]> Die Zeilen 52&vonbis;55 enthalten &tex; Code, der mehr Platz für Fließumgebungen (Tabellen, Grafiken, usw.) auf einer Seite schafft und dazu führt, dass Fließumgebungen eher an der Stelle auftauchen, an der sie im Text stehen. %% set headers \usepackage[automark]{scrpage2} \automark[section]{chapter} \pagestyle{scrheadings} %% uncomment if Latin Modern Type 1 fonts to be used %\usepackage{lmodern} ]]> Sollen die Latin Modern Type 1 Schriften benutzt werden, ist die Zeile 61 einzukommentieren (selbstverständlich müssen die Latin Modern Schriften auch tatsächlich installiert sein). \maketitle \docbookhyphenatefilename ]]> Zeile 69&vonbis;85: das XSL Template für filename wird erweitert: kommen <filename> Elemente in <title> Elementen vor, kann durch das Attribut role="nohyphenation" eine Silbentrennung verhindert werden - was unerwünschte (und in den Stylesheets noch nicht gelöste) Nebeneffekte hätte. \floatstyle{plain} \restylefloat{figure} \floatstyle{plain} \restylefloat{table} \floatstyle{ruled} \newfloat{program}{ht}{lop}[section] \floatstyle{ruled} \newfloat{example}{ht}{loe}[section] \floatname{example}{ example } \floatstyle{ruled} \newfloat{dbequation}{ht}{loe}[section] \floatname{dbequation}{ equation } \floatstyle{boxed} \newfloat{algorithm}{ht}{loa}[section] \floatname{algorithm}{Algorithm} \Large \large \small \footnotesize \normalsize ]]> Aus dem folgenden Template sollten zumindest die Zeilen 12&vonbis;18 in ein bereits existierendes Makefile übernommen werden. Ein ggf. bereits existierendes target dist bzw. clean sollte sinngemäß erweitert werden. Ein make sourcefilename.tex erzeugt die TeX-Datei. Ein make sourcefilename.pdf gleich die PDF-Datei. Ein make validate prüft, ob die Quelldatei demäß der DTD korrekt ist. Für umfangreichere Dokumente, müssen zwischen den pdflatex Läufen ggf. noch andere Kommandos eingefügt werden (z.B. makeindex zur Erzeugung eines Index). Da dies aber bereits zu den fortgeschritteneren Techniken zählt, wird auf Einzelheiten zunächst verzichtet. truncate.sty Treten beim pdflatex bzw. latex Lauf Fehlermeldungen auf, die auf ein fehlendes &latex; Paket truncate.sty hinweisen, muß dies von Hand von CTAN in den lokalen texmf Baum nachinstalliert werden. Für Debian Benutzer hilft die Installation des Paketes pdfscreen, in dem truncate.sty enthalten ist. Alternativ gibt es auf Anfrage von mir ein inoffizielles Debian-Paket, das truncate.sty zur Verfügung stellt. lmodern.sty Die Latin Modern Type 1 Schriften (ftp://ftp.dante.de/tex-archive/fonts/ps-type1/lm/) sind bisher noch nicht Bestandteil von tetex. TeXLive 09/2003 enthält diese bereits, für Debian Benutzer gibt es ein testing/unstable Paket: http://packages.debian.org/lmodern. scrbook.cls Die im normalen tetex enthaltene Version von KOMA-Script ist veraltet. Deshalb empfiehlt sich die manuelle Installation von ftp://ftp.dante.de/tex-archive/macros/latex/contrib/koma-script/. Das Makefile eignet sich für ein make, sudo make install. Zu Erstellung dieses Dokumentes wurden folgende Hilfsmittel benutzt: xsltproc (libxml2-2.6.11/libxslt-1.1.8) als XSLT Prozessor DB2LaTeX XSL Stylesheets (V0.8pre1+20040821) scrartcl [2004/01/07 v2.9p LaTeX2e KOMA document class] aus KOMA-Script