DPML

Definition

DPML ist eine Eigenentwicklung von Matthias Schleiff, die in Zusammenarbeit mit Andreas Lenz entstanden ist.

DPML steht für "Documentation Publisher's Markup Language" und ist eine XML-basierte Auszeichnungssprache, die zielgerichtet für das Erstellen von Technischen Dokumentationen entwickelt wurde.

Prozess der Dokumenterstellung

DPML wurde unter Berücksichtigung des aktuellen Standes von Wissenschaft und Technik entwickelt und ist dem Gedanken des Single Source Publishing verpflichtet.

Die Dokumente werden nach Gesichtspunkten der Semantik klar und logisch strukturiert. DPML bietet für die Inhalte von Technischen Dokumentationen semantisch klare und eindeutige Markup-Elemente, mit denen diese Inhalte ausgezeichnet werden. Durch festgelegte Sequenzen von Elementen erhöht sich die Qualitätssicherheit der Dokumente, weil die richtige semantische Struktur – beispielsweise von Sicherheitshinweisen – durch die DPML-Elemente explizit vorgeben ist.

Als XML-Editor wird Adobe® FrameMaker® verwendet, so dass jederzeit eine Druckvorschau des Dokumetes sichtbar ist (WYSIWYG).

Die folgende Abbildung zeigt den Prozess der Dokumenterstellung mit DPML in einem Funktionsschema:

Dateiformat

Grundlage von DPML ist ein XML-Dateiformat, in dem technische Dokumente zwischengespeichert werden. Aus diesem Dateiformat können mithilfe eigenentwickelter XSLT-Prozesse in einfacher Art und Weise verschiedene Dokumentvarianten (z.B. für verschiedene Produktdokumentationen) erzeugt werden. Diese Dokumentvarianten können für verschiedene Ausgabemedien publiziert werden. Im Moment sind mit DPML Ausgaben in die folgenden Dateiformate möglich:

• PDF – Portable Document Format
• HTML – Hypertext Markup Language
• CHM – Compiled HTML Help

Da es sich bei dem von DPML erzeugten und verwendeten XML-Dateiformat um ein reines Textformat mit einer offenen Spezifikation handelt, ist DPML unabhängig von bestimmter Software nutzbar.

Einsatzbereich

DPML wird von uns für das Erstellen von technischen Handbüchern und Online-Hilfen verwendet. Dabei wurde es bisher erfolgreich in Dokumentationsprojekten für verschiedene Kunden der folgenden Branchen eingesetzt:

• Maschinen- und Anlagenbau
• Schienenfahrzeugbau
• Hard- und Softwareentwicklung

Zum Seitenanfang

Hinweis:
Marken, Firmen oder Produktnamen sind Marken, Firmen oder Produktnamen der jeweiligen Hersteller und/oder Eigentümer.