2009/12 | Fachbeitrag | DITA

DITA - das Baukastenprinzip für Handbücher, Onlinehilfen & Co.

von Prof. Sissi Closs

Das Kürzel DITA steht für „Darwin Information Typing Architecture“ und bezeichnet eine Technik zur Informationsstrukturierung. Das Konzept basiert auf XML und hilft dabei, Inhalte etwa für ein Handbuch oder eine Hilfe so anzulegen, zu verknüpfen und aufzubereiten, dass auch umfangreiche Dokumente sinnvoll organisiert sind und dennoch möglichst wenige Ressourcen beanspruchen. Entwickelt wurde DITA in den 1990ern von IBM, 2005 hat die Organization for the Advancement of Structured Information Standards (OASIS) diese freie Architektur als Standard verabschiedet. DITA wird heute weltweit zum Erstellen von Dokumentation eingesetzt, zum Beispiel für Handbücher, Onlinehilfen, Schulungsunterlagen oder Glossare.

wm: Dokumentationslösungen gibt es bereits einige, welche Besonderheit steckt hinter der Informationsarchitektur DITA?

Sissi Closs: Eine wichtige Komponente ist die Einteilung in Topics. Gewöhnlich werden Informationen hierarchisch dokumentiert. A folgt B folgt C. Es mangelt an der Flexibilität, den Inhalt vom Kontext zu lösen und anderweitig zu verwenden, etwa wenn B noch in anderen Zusammenhängen eine Rolle spielt oder es zu A noch weitere Folgeinformationen gibt. Zusätzlich besteht bei DITA die Möglichkeit, durch Spezialisierungsregeln Strukturen und Typisierungen auf Basis vordefinierter Grundtypen zu erweitern. Sie erben die Definitionen ihres Ursprungs, die dann bei Bedarf angepasst werden können, daher der Name „Darwin“.

 

wm: Was verstehen Sie in diesem Zusammenhang genau unter einem Topic? Oder anders gefragt: Wie viel Information steckt in einem Topic?

Sissi Closs: Ein Topic ist die kleinste sinnvolle Informationseinheit. Wichtig ist, dass in einem Topic nicht mehrere Themen vermischt werden. Nur so können Bausteine entstehen, die sich flexibel mit anderen zu größeren Informationskomplexen verbinden lassen. Vorgabe bei der Topic-Erstellung ist die Wiederverwendbarkeit. Jedes Topic muss so neutral und kontextunabhängig sein, dass es mit anderen kombiniert werden kann, und sollte gleichzeitig eine komplette, in sich geschlossene Information enthalten. Die Idee ist bekannt aus der Welt der Online-Hilfen. Ein Beispiel wäre eine Begriffserklärung: Ist sie als eigenständiges Topic organisiert, kann sie an jeder Stelle, an der der Begriff auftaucht, verwendet werden. Wäre sie dagegen mit ihrer Umgebung verstrickt, würde sich an anderer Stelle der Zusammenhang nicht erschließen. Grundgedanke dabei ist das Single-Sourcing, was bedeutet, dass eine Information in der Quelle nur einmal vorliegt und alle Verwendungen darauf zurückgreifen.

 

wm: Und wie lassen sich diese ganzen Topics organisieren?

Sissi Closs: Dazu wird eine Typisierung benutzt, das heißt der Inhalt wird nach bestimmten Kriterien in Kategorien eingeteilt, etwa „Erklärung“ oder „Anleitung“. Die Grundtypen, die sich für DITA entwickelt haben, sind „Concept“, „Reference“ und „Task“. Das Finden der geeigneten Informationstypen ist nicht einfach, eine Möglichkeit ist mein seit über zehn Jahren bewährtes Klassenkonzept, mit dem systematisch ein Konzeptrahmen erstellt werden kann. Der Vorteil der Typisierung ist, dass nicht für jedes einzelne Topic, sondern nur für jeden Typ ein Konzept erarbeitet werden muss, das dann auf alle entsprechenden Topics angewendet wird. Die Erstellung wird dadurch sehr stringent organisiert und der Nutzer findet sich dank der Konsistenz der Aufbereitung leichter zurecht.

 

wm: Welche anderen Vorteile haben die Anwender durch DITA?

Sissi Closs: Zunächst ist zu sagen, dass DITA eine Investitionssicherheit und Kostenersparnis mit sich bringt, da es sich um Open-Source-Technik handelt. Zudem verkürzt das Konzept die oft langfristige Strukturfindungsphase für Technische Redakteure, indem es einen umfassenden Rahmen absteckt. Vorteile ergeben sich auch aus dem Wachstum der DITA-Nutzer-Gemeinde in den vergangenen Jahren. Durch den breiten Einsatz derselben Basisarchitektur entwickelt sich inzwischen ein Strukturierungs-Know-how, aus dem neue Standards entstehen können – nicht nur für die Inhalte auf unterster Ebene, sondern auch für die daraus zusammengestellten Gebilde, wie zum Beispiel unterschiedliche Handbuchtypen oder Onlinehilfen. Deren breiter Einsatz wiederum wird Austauschbarkeit und Automatisierung in ganz anderen Dimensionen als heute möglich machen. Zudem würde Technischen Redakteuren viel Zeit und Arbeit erspart, die sie Gewinn bringender in die Inhalte investieren könnten.

 

wm: Zu guter Letzt – wie fängt man am besten mit DITA an?

Sissi Closs: Es gibt ein DITA Open Toolkit als Open-Source-Paket, das auch eine Reihe von Transformationen und Skripts enthält, um aus DITA-getaggten Inhalten verschiedene Ausgaben zu produzieren. Dazu zählen HTML, PDF oder JavaHelp. Zusätzlich existieren bereits fertige getaggte Beispieldateien, um die Transformationen auszuprobieren. Softwarehersteller, die den neuen Standard schon unterstützen und entsprechende Konfigurationen für ihre Werkzeuge anbieten, sind unter anderem ASC (Author-it), Adobe (FrameMaker), MadCap (Flare) oder Siberlogic (Sibersafe). Individuelle Beratung und Schulungen zu diesem Thema sind auf jeden Fall empfehlenswert.

Diese Artikel könnten Sie auch interessieren

Linked Data – das Ende des Dokuments?

Dokumente waren bisher stets das zentrale Informationsträger- und Präsentationsmedium zur Wissensvermittlung. Doch dieses rein sequentielle, ausschließlich intellektuell interpretierbare Format reicht in einer zunehmend vernetzten und komplexer werdenden Welt offensichtlich nicht mehr aus....

Weiterlesen

Intelligente Datenhaltung bei der Krämer GmbH Metzingen

WISSENplus
Als Hersteller von Leitern und Industriebegehungen hat die Krämer GmbH aus Metzingen einen in Fachkreisen bekannten Namen. Als im vergangenen Jahr der Umzug in ein neues Firmengebäude anstand, wurde schnell klar, dass das enorme Papierarchiv vorab digitalisiert werden sollte. Durch eine revisionssichere Archivierung müssen die Dokumente nicht mehr im Original aufbewahrt werden....

Weiterlesen

Künstliche Intelligenz revolutioniert die Übersetzungsbranche

Wenn ein Unternehmen über Sprachgrenzen hinweg tätig wird, bedeutet dies immer auch: Es muss sichergestellt werden, dass diese Sprachgrenzen effizient überwunden werden. Wenn das Unternehmen internationale Zulieferer hat – und erst recht, wenn es internationale Märkte bedient – sind akkurate Übersetzungen und Lokalisierungen unerlässlich. Dabei müssen Übersetzungen oft sehr schnell angefertigt w...

Weiterlesen

Hochschule München im Wettbewerb um helle Köpfe

Hochschule München im Wettbewerb um helle Köpfe Wie Wirtschaftsunternehmen stehen auch Hochschulen im globalen Wettbewerb um Ressourcen und die besten Köpfe. Im Bereich der Hochschulbildung gilt dies für Fördergelder und Forschungsmittel genauso wie für Lehrkräfte und potenzielle Studenten. Eine der wichtigsten Informationsquellen für Studienanfänger ist das Internet. Das zeigte sich bei einer Ers...

Weiterlesen

Mehrdimensionale Dokumente für mehrdimensionale Strukturen

Fast schon eine Binsenweisheit: Elektronische Medien verlangen eine andere Informationsaufbereitung als das Medium Papier, es gilt “nur” die medienspezifischen Vor- und Nachteile zu berücksichtigen. So bieten sich für den Bildschirm statt einer linearen Informationsstruktur wie im gedruckten Buch mehrdimensionale Gliederungen an, bei denen die Information nur noch an einer Stelle vorgehalten wird. Ver...

Weiterlesen

Moderne Bankensteuerung braucht eine einheitliche Datenbasis

WISSENplus
Schnell verfügbare und möglichst umfassende Informationen sind ein Essential für langfristig erfolgreiche Bankgeschäfte. Angesichts des umfassenden Wandels in der Bankenwelt und der komplexen gesetzlichen Anforderungen, auf die sich Geldinstitute künftig einzustellen haben, wächst das Erfordernis des Wissensmanagements gerade auch für kleinere und mittelständische Banken....

Weiterlesen

Translation-Memory – Das Gedächtnis des Übersetzers

WISSENplus
Alle Abteilungen innerhalb eines Unternehmens haben eines gemeinsam: Es werden Texte erarbeitet. Angefangen beim Vertrieb, dem Einkauf, der Marketing-Abteilung, dem Projektmanagement und der Dokumentations-Abteilung, um nur einige zu nennen. Die dort zusammengestellten Texte enthalten ähnliche, oft sogar identische Formulierungen. Die Wiederholungsrate beläuft sich erfahrungsgemäß auf 30 bis 40 Prozent ...

Weiterlesen

Eine Quelle für alle Formate und Sprachen

Cross-Media-Publishing oder auch Single-Source-Publishing sind Schlagwörter, die in der technischen Dokumentation immer öfter zu hören sind. Dokumente sollen für alle Formate und Sprachen aus einer Quelle erstellt werden; das vereinfacht das Arbeiten von Autorenteams an unterschiedlichen Standorten und spart Zeit und Kosten. Martin Holzmanns Beitrag zeigt ein Beispiel-Projekt, bei dem diese Schlagworte ...

Weiterlesen