Kapitel 1. Einführung

Inhaltsverzeichnis

1.1. Voraussetzungen

DocBook Publishing ist eine Beschreibung eines Frameworks für das Publishing mit DocBook. Es beschreibt, wie man auf einfache Weise eine Publikation oder einen Artikel in den unterschiedlichsten Formaten erzeugen kann. Sie können diesen Artikel online lesen oder ihn in verschiedenen Formaten herunterladen. Dieses ganze Framework beruht auf der Arbeit von sehr vielen Leuten, die viele Teile dazu beigetragen und der Allgemeinheit als Open-Source zur Verfügung gestellt haben. Herausheben möchte ich Mark Pilgrim, der mich mit seinen Publikationen, insbesondere Dive Into Python, zu diesem Artikel inspiriert hat. Ich habe nichts weiter getan, als das ganze unter Windows und auf deutsch mit allen notwendigen Tools zum Laufen zu bringen und nun meinerseits damit zu arbeiten: Dieser Artikel hier ist selbstverständlich damit verfasst.

Um es noch einmal hervorzuheben: es geht mir hier nicht so sehr um DocBook an sich, hier will ich auf andere Sites verweisen, vielmehr soll ein Setup beschrieben werden, wie man das Ganze praktisch zum Laufen bekommt. Außerdem sind auf der WebSite auch alle erforderlichen Tools zum Download (auch als Binary) angeboten, so dass es nicht schwer fallen sollte, selbst ein System zusammen zu stellen, um so erfolgreich Dokumente mit DocBook schreiben zu können.

1.1. Voraussetzungen

Es ist wichtig zu verstehen, dass sich bei diesem Framework nicht um eine WYSIWYG Lösung handelt oder eine „Klick-Klack-Anwendung“ (eine Windows-Applikation, die sich per Maus bedienen lässt). Vielmehr werden Artikel im Quelltext in DocBook (also XML) geschrieben und anschließend „compiliert“. Das erinnert manchen vielleicht noch an die alten TEX-Zeiten, wo das Schreiben eines Dokuments so ähnlich abgelaufen ist.

Wer sich also gänzlich vor der Kommandozeile scheut, der sollte vielleicht lieber die Finger davon lassen und sich weiter mit gängigen Officetools bescheiden.

Der Umgang mit XML und etwas XSLT sollte einem ebenso geläufig sein, damit man nicht schon an den einfachsten Dingen scheitert. Alles Weitere will ich hier versuchen so weit zu erläutern, dass man schon bald ein erstes Ergebnis erzielen kann.