DITA trifft iiRDS: Erstellung von iiRDS-Paketen leicht gemacht mit dem neuen Plug-in für DITA Open Toolkit

Das iiRDS-Konsortium der tekom hat am 22. März ein kostenfreies Plug-in für das DITA Open Toolkit veröffentlicht. Im Herbst 2023 wurde mit der Veröffentlichung der "IEC PAS 63485:2023" ein wichtiger Meilenstein für die internationale Relevanz von iiRDS erreicht. Jetzt liefert das Konsortium mit dem Plug-in ein einfach zu bedienendes und anpassbares Tool, um den DITA-Nutzern eine einfache Generierung von iiRDS-Paketen aus dem DITA-Umfeld zu ermöglichen. 

Über DITA  

Darwin Information Typing Architecture (DITA) ist ein etablierter Authoring-Standard und wird von einem Open-Source-Toolkit, dem DITA Open Toolkit DITA-OT, unterstützt. Mit DITA-OT können HTML, PDF und andere Ausgabeformate aus Ihren DITA-Dateien erzeugt werden. Durch die Trennung von Informationen in Topic-Typen und XML als Grundlage ist DITA für die Technische Kommunikation bestens geeignet. DITA ermöglicht die Erstellung granularer Informationen, die in Content-Delivery-Portale, Chatbots und KI-basierte Szenarien wie Retrieval-Augmented Content Generation einfließen. 

Über iiRDS  

Metadaten sind eine Voraussetzung für den sinnvollen Einsatz dieser Mikroinhalte. Hier kommt der intelligent information Request and Delivery Standard (iiRDS) zum Einsatz. iiRDS gibt es seit 2016 und wird inzwischen von vielen Content-Delivery-Portalen unterstützt. Der Standard wird vom iiRDS-Konsortium verwaltet, das sich aus Industrieunternehmen, Systemhäusern, Beratern und Dienstleistern und Organisationen zusammensetzt, mit der Gesellschaft für Technische Kommunikation – tekom Deutschland e.V. als führendem Mitglied.  

Sowohl DITA als auch iiRDS sind themenorientiert und ermöglichen es den Benutzern, genau die Informationen zu erhalten, die sie benötigen. Dazu stellt iiRDS ein Austauschformat zur Verfügung, das häufig verwendet wird, um Technische Dokumentation aus Content-Management-Umgebungen in Content-Delivery-Szenarien zu veröffentlichen. iiRDS definiert ein Paketierungsformat und ein erweiterbares Metadatenschema.  

Über das Plug-in 

Das iiRDS-Plug-in folgt den Prinzipien von DITA-OT. Auch wenn keine expliziten Metadaten in der DITA-Datei vorhanden sind, generiert das Plug-in nützliche iiRDS-Pakete mit Dokumenten, Topics, Topic-Typen und einer Navigationsstruktur. Da das Hauptziel des Plug-ins darin bestand, die Nutzung zu vereinfachen, werden nicht alle iiRDS-Metadaten von Haus aus unterstützt, allerdings wurde die Möglichkeit geschaffen, Aspekte der iiRDS-Paketierung anzupassen.  

Im November 2023 hat das iiRDS-Konsortium die Entwicklung dieses Plug-ins in Auftrag gegeben. Es wurde von der Empolis Information Management GmbH entwickelt und der parson AG getestet und dokumentiert.  

Interessierte finden das Plug-in und weiterführende Informationen auf der iiRDS-Webseite unter https://www.iirds.org/tools/dita-plugin. Das Plug-in ist unter der Apache-2.0-Lizenz veröffentlicht und steht der DITA-Gemeinschaft zur Nutzung und Anpassung offen.