imported>Elarane: Änderung der Formulierung.

2024-08-11T22:00:49Z

Änderung der Formulierung.

Neue Seite

Die '''Darwin Information Typing Architecture''' ('''DITA''') ist ein [[Dokumentenformat]], ähnlich dem bekannten [[DocBook]]. DITA wird vom [[Organization for the Advancement of Structured Information Standards|OASIS]] DITA Technical Committee als freie Architektur entwickelt<ref>{{Internetquelle |url=https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=dita#overview |titel=OASIS Darwin Information Typing Architecture (DITA) TC {{!}} OASIS |abruf=2020-08-01}}</ref> und steht als [[Dokumenttypdefinition]] (DTD) kostenlos zur Verfügung. Das Format basiert auf [[Extensible Markup Language|XML]]: Im Gegensatz zu DocBook gibt es für DITA keine [[Standard Generalized Markup Language|SGML]]-basierte Dokumenttypdefinition (DTD).

Nach der offiziellen Definition aus der Architekturspezifikation (nachstehend in deutscher Übersetzung) ist DITA
{{Zitat
|Text=… eine Architektur, um themenorientierten, informationstypisierten Inhalt in Form einer einzigen Quelle (single source) zu erstellen, der in vielfältiger Weise wiederbenutzt werden kann. DITA ist auch eine Architektur, um neue Informationstypen zu erstellen sowie neue Informationsdomänen — basierend auf vorhandenen Typen und Domänen — zu beschreiben. Dies ermöglicht es Gruppen von Benutzern, sehr spezifische, zielgerichtete Dokumenttypdefinitionen zu erstellen, indem ein Spezialisierung genannter Prozess verwendet wird, bei dem die gemeinsamen Ausgabetransformationen und Gestaltungsrichtlinien für allgemeinere Typen und Domänen dennoch beibehalten werden.
|ref=<ref name="DITA.Architectural.Specification.2">''DITA Architectural Specification'', Chapter 2, ''An Introduction to DITA.''</ref>}}

== Einführung ==

Der Name ''Darwin Information Typing Architecture'' kommt folgendermaßen zustande<ref>{{Internetquelle |url=http://www.ibm.com/developerworks/library/x-dita3/index.html |titel=Frequently Asked Questions about the Darwin Information Typing Architecture |datum=2005-09-28 |abruf=2020-08-01 |sprache=en}}</ref>:
* ''Darwin'' – DITA verwendet Spezialisierung und [[Vererbung (Programmierung)|Vererbung]], analog zu [[Charles Darwin]]s Ideen zur [[Über die Entstehung der Arten|Entstehung der Arten]].
* ''Information Typing'' – Informationseinheiten werden in DITA ihrem Inhalt nach typisiert.
* ''Architecture'' – DITA ist eine Architektur. Sie ist nicht nur einfach eine DTD, sondern beinhaltet auch Regeln für die Ableitung von neuen Informationseinheiten.

DITA ist eine XML-basierte Architektur für die Erstellung, Verteilung und Wiederverwendung von technischen Informationen. Die Architektur besteht aus einer Menge an Designregeln, die es erlauben, „typisierte“ Informationsmodule auf der Ebene sogenannter „Topics“ zu erstellen.

Ziel von DITA ist es, den „unique transclusion mechanism“ (siehe auch „[[Transklusion]]“) zu unterstützen, der im Rahmen einer DTD Verarbeitungsregel angegeben wird:
{{Zitat
|Text=Ein Element kann sich selbst mit einem anderen, typgleichen Element ersetzen, das sich entweder im aktuellen Topic befindet oder in ein einem getrennten Topic, das dieselben Inhaltsmodelle verwendet. DITAs Transklusionsmechanismus ist ähnlich dem SGML-conref-Mechanismus, der ein leeres Element als Referenz auf ein anderes, nichtleeres Element verwendet. DITA erfordert jedoch zumindest ein minimales Inhaltsmodell für das referenzierende Element und führt während der Verarbeitung Prüfungen durch, um sicherzustellen, dass das ersetzende Element in seinem neuen Kontext gültig ist. Dieser Mechanismus geht über den Standardmechanismus XInclude hinaus, da Inhalt nur dann eingefügt werden kann, wenn er äquivalent ist: Wenn die Typen des wiederverwendenden (referenzierenden) und des wiederverwendeten (referenzierten) Elements voneinander abweichen, wird die Inhaltsreferenz nicht aufgelöst. DITAs Transklusionsmechanismus geht auch über den Standardmechanismus der Entitäts-Wiederverwendung hinaus, da sich der wiederverwendete Inhalt in einer XML-Datei mit einer DTD befinden kann. Das Endresultat ist, dass wiederverwertete Inhalte zum Zeitpunkt ihrer Erstellung validiert werden, statt zum Zeitpunkt der Wiederverwendung, und somit Probleme an ihrer Quelle gefunden werden.}}

== Geschichte ==
Das Unternehmen [[IBM]] erstellte in den 90er-Jahren eigene komplexe [[Standard Generalized Markup Language|SGML]]-DTDs (u. a. [[IBMIDDoc]]) für die Dokumentation seiner zahlreichen Produkte. Während der Weiterentwicklung entstand die Aufgabe, einen neuen Standard für technische Dokumentationen zu entwerfen, der ein hohes Maß an Wiederverwendung unterstützen sollte. Ein weiteres wichtiges Ziel war es, Anwendern die Möglichkeit zu geben, das Informationsmodell zu erweitern, ohne dadurch inkompatibel mit anderen DITA-konformen Anwendungen zu werden. Dabei wurden IBMIDDoc oder andere [[Extensible Markup Language|XML]]-DTD wie [[DocBook]], [[Text Encoding Initiative|TEI]] oder [[Extensible Hypertext Markup Language|XHTML]] untersucht. Als Resultat entschied man, mit DITA ein neues Dokumentenformat zu entwickeln.<ref name=":0">{{Literatur |Autor=Eliot Kimber |Titel=DITA for Practitioners Volume 1: Architecture and Technology |Hrsg= |Sammelwerk= |Band= |Nummer= |Auflage=1 |Verlag=XML Press |Ort= |Datum=2012 |ISBN=978-1-937434-06-9 |Seiten=}}</ref>

Am 3. Mai 2005 wurde DITA 1.0 von IBM an OASIS übergeben und als OASIS-Standard verabschiedet.

Im August 2007 wurde DITA 1.1 als OASIS-Standard verabschiedet. Zu den wesentlichen Neuerungen gehören u. a. die ''Bookmap''-Spezialisierung und die Formalisierung der DITAVAL-Syntax zur Filterung von Inhalten.<ref>{{Internetquelle |url=http://docs.oasis-open.org/dita/v1.1/CS01/archspec/ditaspec.html |titel=About the DITA 1.1 Specification |abruf=2020-08-04 |sprache=en-us}}</ref>

Am 1. Dezember 2010 wurde die DITA-Spezifikation 1.2 als OASIS-Standard mit zahlreichen Neuerungen verabschiedet. Eine wesentliche Neuerung in dieser Version ist die indirekte Adressierung über einmalig definierte Schlüssel. ''Subject Scheme Maps'' ermöglichen es [[Attribut (Auszeichnungssprache)|Attributwerte]] zu kontrollieren und [[Taxonomie]]n zu modellieren. Der ''Constraint''-Mechanismus und neue [[Element (Auszeichnungssprache)|Elemente]] sollen die Anpassung des Inhaltsmodells erleichtern. Darüber erweitert diese Version den Standard um neue Mechanismen für die Wiederverwendung von Inhalten. Version 1.2 ergänzt das Inhaltsmodell um neue Spezialisierungen (''Machinery Industry'', ''Training'').<ref name=":0" />

Am 17. Dezember 2015 wurde die DITA-Spezifikation 1.3 als OASIS-Standard verabschiedet.<ref>{{Internetquelle |url=https://www.oasis-open.org/news/announcements/dita-v1-3-oasis-standard-published |titel=#DITA V1.3 OASIS Standard published {{!}} OASIS |abruf=2020-08-01}}</ref> Ab dieser Version unterstützt DITA [[RELAX NG|Relax NG]] als normative [[Schemasprache (XML)|Schemasprache]]. Die Version gruppiert die Spezifikation in drei aufeinander aufbauende Pakete: ''Base'', ''Technical Content'' und ''All Inclusive''. Die indirekte Adressierung wird um die Möglichkeit erweitert, einem Schlüssel mehrere verschiedene Werte zuzuweisen.<ref>{{Internetquelle |autor=Leigh W. White |url=https://www.oasis-open.org/committees/download.php/56472/Understanding%20Scoped%20Keys%20In%20DITA%201.3.pdf |titel=DITA 1.3 Feature Article:Understanding Scoped Keys in DITA 1.3 |werk=oasis-open.org |hrsg=OASIS DITA Adoption Technical Committee |datum=2015-09-09 |abruf=2020-08-01 |sprache=en}}</ref> Weiter führt diese Version den neuen Topic-Typen ''troubleshooting'', sowie neue Domänen für [[Releasemanagement]], [[Mathematical Markup Language|MathML]] und [[Scalable Vector Graphics|SVG]] ein.<ref>{{Internetquelle |url=https://www.oasis-open.org/news/pr/members-approve-dita-1-3-as-oasis-standard-for-authoring-and-publishing |titel=Members Approve DITA 1.3 as OASIS Standard for Authoring and Publishing {{!}} OASIS |abruf=2020-08-04}}</ref> Im Oktober 2016 wurde DITA V1.3 Errata 01 von OASIS verabschiedet.

== Eigenschaften und Hintergründe ==

DITA zeichnet sich vor allem durch folgende Eigenschaften aus:

* ''Themenzentrierung'' – Das höchste Abstraktionslevel von DITA ist das „Topic“ (dt. „Thema“). Weitere Strukturen, die oberhalb eines Topics angesiedelt sind, sind dann eher Informationen, die dem Prozess eines solchen Topics angehören. Beispielsweise könnte es sich dabei um die Navigation einer Hilfeseite handeln. Weiterhin sind Topics nicht mehr weiter geschachtelt. Für die Organisation von Topics bieten sich die „Sections“ (dt. „Abschnitte“) an, welche die Topics mit Inhalten versehen.
* ''Wiederverwendung'' – Ein Ziel von DITA ist die Reduktion von [[Redundanz (Informationstheorie)|Redundanz]] und damit des Kopieraufwands von Informationen. Dabei können Informationen an mehreren Stellen verwendet werden, der Inhalt existiert jedoch nur einmal.

Definitionen:<ref name="DITA.Architectural.Specification.2" />
* ''Topic:'' Ein Topic ist eine Informationseinheit, die durch Titel und Inhalt bestimmt wird. Diese Einheit muss knapp genug sein, um ein einzelnes Thema zu behandeln oder eine einzige Frage zu beantworten. Sie muss jedoch auch ausreichend genug sein, um allein sinnvoll stehen zu können und dabei allein weiterentwickelt zu werden.
* ''Map:'' Maps sind Dokumente, in denen einzelne Referenzen zu Topics sinnvoll gesammelt und organisiert sind. Sie bilden damit die logische Einheit und Klammer über bestimmte Topics. Sie können damit auch als Gliederung oder Inhaltsverzeichnis für DITA-Ergebnisse und somit als „build manifests“ für vollständige DITA-Projekte dienen.
* ''Spezialisierung:'' Die Spezialisierung erlaubt die Definition neuer „Informationstypen“ (“structural types” oder “new domains of information”). Dabei sollte jedoch der größte Anteil der Informationen wiederverwendet werden, damit die Kosten für Austausch, Migration und Wartung minimiert werden können.
* ''Integration:'' Jede Spezialisierung besitzt ihr eigenes Designmodul. Diese Module können in kombinierter Form wiederum weitere Dokumententypen generieren. Der Prozess der Erstellung neuer Dokumententypen aus der Kombination verschiedener Module wird „Integration“ genannt.
* ''Anpassung:'' Für den Fall, dass ausschließlich das Arbeitsergebnis (“output”) in unterschiedlicher Form benötigt wird, kann eine Anpassung von DITA verwendet werden. Damit wird die Ausgabe angepasst, ohne die Übertragbarkeit und den Austausch zu verschlechtern.

== Vorteile gegenüber und Vergleich mit DocBook ==
{{Überarbeiten}}

Im Vergleich zu DocBook gilt DITA als einfacher zu erlernen. Während DocBook eher als Vorlage für komplexe Bücher und Dokumentationen im Buchformat gedacht ist, verfolgt DITA das Ziel, technische Informationen als „Topics“ abzubilden, die in verschiedenen Kontexten weiterverwendet werden können. DITA verwendet darüber hinaus viele Elemente aus [[Hypertext Markup Language|HTML]].

Nachfolgend ein Vergleich:<ref>nach {{Webarchiv|text=Namahn, 2001 |url=http://www.namahn.com/resources/documents/note-DITA.pdf |wayback=20050512105052 }} (PDF)</ref>

=== Vorteil von DITA gegenüber DocBook ===

* DocBook ist primär für die Erstellung und Auslieferung von Büchern gedacht, während DITA dagegen auf die Erstellung und Auslieferung auf „Topics“ fokussiert. Diese Topics können jedoch danach als Sammlung in Bücher übergehen oder verlinkt werden und damit als Hilfe-Informationen, Webseiten oder andere Formate dienen.
* DocBook ist strikt hierarchisch und stellt keine Mechanismen zur Verfügung, um Inhalt vom Kontext zu trennen. Dabei ist DITA wesentlich flexibler und kann kontextabhängige Informationen in verschiedenen Dokumenten gruppieren. DITA kann Topics mit jedem Level von definierter Struktur ablegen.
* DocBook ist eine feste Menge von Elementen und Attributen. DITA ist erweiterbar und kann auf die individuellen Bedürfnisse und Anforderungen angepasst werden: Spezialisierungsregeln definieren die Struktur von individuellen Informationstypen, die dabei auf die vorhandenen Standardelemente zurückgreifen können.

=== Vorteil von DocBook gegenüber DITA ===

* DocBook wird seit mehr als zehn Jahren aktiv erweitert und ständig gepflegt.
* DocBook ist ausführlich dokumentiert und in vielen Praxisfällen erfolgreich getestet. Hilfestellungen der großen DocBook-Community sind überall verfügbar.
* DocBook unterstützt durch die „DocBook-Stylesheets“ bereits eine Vielzahl an Zielformaten wie Eclipse, [[EPUB]], [[Extensible Stylesheet Language – Formatting Objects|FO]], HTML, [[CHM (Dateiformat)|HTMLHelp]], Javahelp, [[Manpage]]s, Webhelp und [[Extensible Hypertext Markup Language|XHTML]].
* Ab Version 5 stellt DocBook ein <code>topic</code>-Element bereit.
* Ab Version 5.1 (in Entwicklung) wird es ein <code>assembly</code>-Element geben (ähnlich einer Map in DITA), das die Wiederverwertung verbessert.

== Beispiel ==
<syntaxhighlight lang="xml">
<topic id="maintaining" xml:lang="en-us">
<title>Maintaining</title>
<shortdesc>
You maintain your solution to ensure that all components are operating at maximum efficiency.
</shortdesc>
<body>
<p>
Maintenance is a task that you perform along with configuration to get the most from your solution.
</p>
</body>
</topic>
</syntaxhighlight>

== Siehe auch ==
* [[mumasy]], ein [[Verband Deutscher Maschinen- und Anlagenbau|VDMA]]-standardisiertes XML-Schema für technische Dokumentation

== Literatur ==
* [[Sissi Closs]]: ''Single Source Publishing. Topicorientierte Strukturierung und DITA''. Entwickler-Press, 2007, ISBN 978-3-935042-98-7
* Johannes Hentrich: ''DITA – Der neue Standard für technische Dokumentation''. XLcontent-Verlag, 2008, ISBN 978-3-9811430-0-3
* Jennifer Linton, Kylene Bruski: ''Introduction to DITA: A User Guide to the Darwin Information Typing Architecture.'' Comtech Services, Colorado 2006

== Weblinks ==
* [http://www.oasis-open.org/committees/dita/ OASIS Technical Committee] (englisch, mit Links zu den Spezifikationen)
* [http://www.ibm.com/developerworks/xml/library/x-dita1/?ca=dgr-wikiaDita1 IBM DITA Spezifikation] (englisch)
* [http://www.ibm.com/developerworks/xml/library/x-dita3/?ca=dgr-wikiaDita2 IBM DITA FAQ] (englisch)
* [http://www.ibm.com/developerworks/xml/library/x-dita6/x-dita_downloads.html?ca=dgr-wikiaDitadwnloads IBM DITA Download] (englisch)
* [http://www.data2type.de/xml-xslt-xslfo/dita/ data2type – Ausführliche Einführung in DITA] (deutsch)
* [https://www.learningdita.de/ learningdita – e-Learning-Plattform zum Erlernen von DITA] (deutsch).
* [https://www.xing.com/communities/groups/darwin-information-typing-architecture-dita-1012092 DITA-Gruppe und Forum] auf xing.com (deutsch)
* [https://groups.yahoo.com/neo/groups/dita-users/info DITA-Gruppe und Mailing-Liste] auf yahoo.com (englisch)
* [http://www.dita-ot.org/ DITA Open Toolkit] (englisch)
* [http://xml.coverpages.org/dita.html Referenzen] (englisch)

== Einzelnachweise ==
<references />
{{Normdaten|TYP=s|GND=7553991-3}}

[[Kategorie:Organization for the Advancement of Structured Information Standards]]
[[Kategorie:Datenformat]]
[[Kategorie:XML-basierte Sprache]]
[[Kategorie:Technische Dokumentation]]

Darwin Information Typing Architecture - Versionsgeschichte

imported>Elarane: Änderung der Formulierung.