+++
title = "das eklige Gesicht XMLs"
date = "2009-08-28T12:23:00+00:00"
author = "Gibheer"
draft = false
+++

Eigentlich ist es nicht schwer eine Dokumentation zu schreiben. Es wird
nur dann schwer, wenn verschiedene Ausgabeformate dabei herauskommen
sollen.

Ich habe keine Ahnung wie das die verschiedenen “Open Source”-Projekte
schaffen, aber f&uuml;r mich war es die riesen Chance mal Docbook
ausprobieren zu k&ouml;nnen. Netbeans hat mit dem Milestone 1 der
Version 6.8 auch wieder Support daf&uuml;r, aber ich bin sehr
entt&auml;scht.

Docbook ist dazu gedacht B&uuml;cher, Texte und Artikel zu schreiben,
ohne sich Gedanken um die Formatierung machen zu machen. Allerdings gibt
es so einen riesen Berg an Tags, dass ich schon froh war, dass Netbeans
mir ein Template zur verf&uuml;gung gestellt hat.

Es artete aber immer mehr aus, als ich eine
[Liste](http://docbook.org/tdg/en/html/itemizedlist.html) und
sp&auml;ter auch noch eine
[Tabelle](http://docbook.org/tdg/en/html/table.html) bauen wollte.

Es sind dazu so viele Tags von n&ouml;ten, &uuml;ber die man sich bei
verschiedenen Quellen informieren muss, wie es denn gedacht ist, dass
sie benutzt werden, dass man eigentlich mehr Zeit damit verbringt sich
zu merken, wie die Liste funktioniert, als dass man Doku/Buch/…
schreibt.

Aus Frust &uuml;ber diesen herben R&uuml;ckschlag habe ich jetzt einfach
angefangen mir meine eigene XML-Syntax zu bauen und gleich nebenher die
XSLT zu schreiben. Das ist wahrscheinlich einfacher als sich in diesen
Berg von Tags einzuarbeiten.
