blog.meimberg.info

Da ich in der Verlegenheit war, ein größeres Kundenprojekt nun ausführlich zu dokumentieren, habe ich mich etwas umgesehen und bin dabei auf DocBook gestoßen. DocBook ist ein XML-Markup, das die Strukturen üblicher (vorwiegend technischer) Dokumentationen abbildet. Mit zur Spezifikation gehört, neben einer Reihe von DTDs und Schemas, auch ein Set von XSLT-Stylesheets, die aus den XML-Dokus Websites, bzw. HTML-Dokumentationen und fo-xsl-Markup (!!) erzeugen.
So ganz transparent ist mir die Projektstruktur, offen gesagt, jedoch nicht. Verwaltet wird die Spec von einer Kommission OASIS. Es gibt zum darüberhinaus jedoch noch dokbook.org, hier wird u.A. von O’Reilly ein Buch über DocBook (natürlich als DocBook-Format) angeboten. Dann gibt es noch sourceforge.net/projects/docbook, hier werden offensichtlich die Stylesheets gehosted.
Wirklich spannend ist jedoch der docbook-styler, eine fertige freie Distribution der (leicht modifizierten) Stylesheets mit einem Set von ANT-Skripten. So etwas ist dringend nötig, da man mit einem Sack von (schlecht dokumentierten) Stylesheets und Schemas von sourceforge noch nicht wirklich per Knopfdruck eine Dokumentation erzeugen kann. Mit dem docbook-Styler geht das! Geschrieben, bzw. Zusammengestellt wurde der dokbook-Styler von Dawid Weiss, einem freundlichen Herrn, der erkannt hat, dass in der Standard-Distribution von DocBook irgendwie noch was fehlte, damit man sie wirklich verwenden kann. Vielen Dank David Weiss!!!