Zwei der für technische Dokumentation verfügbaren standardmäßigen strukturierten Anwendungen sind DITA und DocBook.
DITA
DITA (Darwin Information Typing Architecture) bietet eine standardmäßige DTD und einen Satz von Regeln speziell zum Schreiben von Onlinedokumentation wie Software-Hilfedateien. Es wird eine Tag-Struktur definiert, die für Authoring, Erstellen und Liefern technischer Dokumentation geeignet ist. Zu den Tag-Typen in DITA zählen <topic>, <title>, <shortdesc>, <prolog>, <body> und <concept>. Im Folgenden sind einige typische DITA-Funktionen aufgeführt:
•DITA ist themenorientiert. Jedes Thema (Topic) ist eine modulare Satzkonstruktion, die in verschiedenen Kontexten wieder verwendet werden kann.
•Da DITA Inhalt von Kontext trennt, sind mehrere Informationsarchitekturen in DITA möglich. DITA kann auch erweitert werden, um die Definition von Informationstypen zu ermöglichen.
•DITA ist themenbasiert. Es sind drei grundlegende Thementypen möglich, diese Thementypen können jedoch den individuellen Anforderungen entsprechend angepasst werden.
•DITA verwendet eine ditamap, die Links zu den XML-Dateien im Dokumentationssatz enthält. Jede XML-Datei kann ein Thema oder eine Themensammlung darstellen.
•Für DITA sind verschiedene Ausgabeformate möglich, beispielsweise PDF, HTML usw. Die Ausgabeformate müssen jedoch entwickelt werden.
•DITA eignet sich besser für umfangreichere Dokumentationssätze.
DocBook
DocBook ist ebenfalls ein offener Standard, der für technische Artikel und Dokumentation entwickelt wurde. DocBook enthält eine DTD zum Schreiben von technischen Büchern und Artikeln in einem entsprechenden Format. Zu DocBook-Tags zählen <article>, <section>, <title>, <articleinfo> und <pubdate>.
Im Folgenden sind einige typische DocBook-Funktionen aufgeführt:
•DocBook ist mehr buch- oder abschnittsorientiert.
•DocBook hat normalerweise eine hierarchische Struktur und kann nur für wirkliche Single-Source-Dokumente entwickelt werden. Der Inhalt ist unabhängig vom Kontext.
•DocBook weist einen festen und umfangreichen Satz von Elementen und Attributen auf.
•DocBook bietet eine XML-Include-Datei, die alle anderen Dateien enthält.
•DocBook-Ausgaben können im Format PDF, HTML und HTMLHelp erfolgen. Mit etwas Entwicklungsaufwand können diese auf andere Ausgabeformate erweitert werden.
•DocBook ist einfach einzurichten und eignet sich besser für kleine bis mittelgroße Dokumentationssätze.