iiRDS-Pakete aus DITA-XML veröffentlichen – mit dem neuen Plugin für DITA-OT

Ab sofort können Sie iiRDS-Pakete aus DITA-XML veröffentlichen, basierend auf vorhandenen Metadaten. Möglich macht dies ein neues, kostenloses Plugin für das DITA Open Toolkit (DITA-OT), das vom iiRDS-Konsortium entwickelt wurde. Jedes Redaktionssystem und CCMS, das das DITA-OT verwendet, kann nun iiRDS-Pakete erzeugen.

Über DITA-XML

DITA-XML ist ein XML-Standard für Technische Dokumentation, der topic-basiertes Schreiben, Wiederverwendung und Single-Source-Publishing ermöglicht. Da DITA auf dem XML-Format basiert, ermöglicht der Standard mithilfe des DITA Open Toolkit (DITA-OT) eine einfache Publikation Ihrer Dokumentation in verschiedenen Ausgabeformaten.

Sie möchten DITA lernen? Wir bieten die E-Learning-Plattform "DITA lernen", auf der Sie kostenfrei DITA-XML lernen können.

Über iiRDS

iiRDS ist ein offener Standard, der die herstellerunabhängige Auslieferung von intelligenten Informationen ermöglicht. iiRDS definiert ein Metadatenmodell, das sowohl Standardmetadaten enthält als auch individuell an die Bedürfnisse von Produkten oder Unternehmen angepasst werden kann. Die Auslieferung von iiRDS-konformen Inhalten erfolgt in sogenannten Paketen, bei denen es sich um Container mit einer vorgegebenen Verzeichnisstruktur handelt. Die Pakete enthalten die Inhalte in beliebigen Formaten, z.B. HTML, und die dazugehörigen Metadaten als RDF-Datei.

Was ermöglicht das neue Plugin?

Mit dem neu entwickelten Plugin für DITA-OT können Sie iiRDS-Pakete aus Ihren DITA-XML-Quellen erstellen. Für die Inhalte wird das Format HTML verwendet.

Das Plugin nutzt zunächst die normale Vorverarbeitung (Preprocessing) der DITA-Dateien durch das DITA-OT. Anschließend werden die Metadaten aus den DITA-Topics und DITA-Maps ausgelesen und eine RDF-Datei erzeugt. Auch wenn in den Quelldateien noch keine expliziten (iiRDS-) Metadaten vorhanden sind, wird die RDF-Datei trotzdem erzeugt; dabei werden für einige Metadaten Standardwerte gesetzt, z. B. „iirds:OperatingInstruction“ für „iirds:DocumentType“.

Zum Schluss erstellt das Plugin die Verzeichnisstruktur für das iiRDS-Paket auf Grundlage der DITA-Map und erzeugt das Ausgabeformat HTML für die einzelnen Topics. Zuletzt wird das iiRDS-Paket erstellt. Dieses enthält die HTML-Topics für die Inhalte und die RDF-Datei für die Metadaten.

Individuelle Anpassungen möglich

Sie können das Plugin individuell anpassen, um produkt- oder unternehmensspezifische Bedürfnisse zu erfüllen. So können Sie das Layout der Publikation ändern, weitere Schritte zur Vorverarbeitung hinzufügen oder ein individuelles Metadaten-Mapping verwenden, um z. B. Metadaten aus bestimmten Elementen oder Attributen der DITA-XML-Quelle auszulesen und auf iiRDS zu mappen.

Darüber hinaus können Sie die Generierung der „Unique Identifiers“ (IRIs) anpassen, um auch hier eigene Werte mitgeben zu können.

Download

Laden Sie das Plugin und seine Dokumentation kostenfrei herunter.

Noch mehr erfahren

Mark Schubert und Martin Kreutzer (Empolis) präsentieren das Plugin im tcworld-E-Magazine.

Ulrike Parson und Marion Knebel haben das Plugin im Rahmen des Webinars "Publishing with iiRDS from DITA" bei der Society for Technical Communication am 26. März 2024 vorgestellt.

Einen eher technischen Zugang zum Plugin bietet Marion Knebel, Senior Technical Communicator bei parson, in ihrem Vortrag auf dem DITA-OT Day 2024: "Publishing with iiRDS from DITA".

Sie möchten Technische Dokumentation mit DITA-XML erstellen? Wir finden Ihre individuelle DITA-Lösung. Mehr erfahren