DocBook (http://en.wikipedia.org/wiki/DocBook Wikipedia DocBook) ist eine XML-Beschreibungssprache für Dokumente. Es ist gut geeignet, um aus einem Quell-(DocBook-)Dokument verschiedene Ausgaben, z.B. als HTML, PDF oder EPub zu erzeugen. Um das zu erreichen, wird der Text in DocBook lediglich in Tags eingeschlossen, die die Bedeutung des Textes innerhalb des Dokumentes markieren. Konkrete Formatierungen sind nicht nötig (und auch nicht möglich), weil diese dem entsprechenden Umwandler in das Zielformat unterliegen.

Um sich in das Format einzuarbeiten, sollte man zuerst einmal DocBook - The Definitive Guide lesen.

Editoren #

Letztlich ist DocBook XML und kann daher leicht mit jedem Texteditor geschrieben werden. Die besten Ergebnisse erreicht man jedoch mit einem guten XML-Editor. Ist man jedoch auf der Suche nach einem WYSIWYG-Editor und möchte dann womöglich noch freie Software einsetzen, wird die Luft aber dann doch irgendwann dünn. Es gibt in der Wikipedia eine Vergleichsliste von XML-Editoren.

• Vex scheint das einzige echte und lebende freie Projekt eines XML WYSIWYG-Editors zu sein, der gut mit DocBook umgehen kann.
• JEdit mit XML-Plugin kann zwar kein WYSIWYG, ist aber ein Editor für Programmierer, den man auch im Auge behalten sollte. Wenn ich nicht inzwischen fast alles nur noch in Exlipse machen würde, würde ich diesen Editor lieben.

Validieren #

Wer möchte, kann eine DocBook-Datei validieren, d.h. prüfen, ob diese eine gültige Datei ist und alle Elemente richtig verwendet wurden.

Im DocBook-Buch wird als Tool zum Validieren auf der Kommandozeile "Sun MSV" empfohlen. Das bekommt man eigentlich unter https://msv.java.net/. Leider hat wohl die Projektseite (wie so viele) unter dem Umzug von java.net nach der Oracle-Übernahme arg gelitten. Daher ist wohl das Wiki und die Dokumentation weg und die neueren jar-Files ergaben für mich kein lauffähiges Programm (sondern nur Bibliotheken). Allerdings bekommt man unter "older Downloads" eine Version von 2009, die für die Beispiele aus dem Buch wunderbar funktioniert.

Einführungen, Anleitungen und Links #

• Lars Vogel (vogella.com) hat auch zu diesem Thema bereits gearbeitet und einen Artikel über die Arbeit mit DocBook in Eclipse (u.a. mit Vex) geschrieben.
• IBM Developerworks hat auch einen Artikel zu DocBook in Eclipse
• DEP4E ist ein Projekt, um DocBook-Komponenten in Eclipse einzubinden. Ich habe es noch nicht ausprobiert, es scheint aber bis auf den WYSIWIG-Editor alles da zu sein.