XML steht für Extensible Markup Language, auf Deutsch erweiterbare Auszeichnungssprache. Sie beschreibt Inhalte und deren Struktur in einem textbasierten Format. Dazu werden Inhalte mit benannten Elementen gekennzeichnet. Attribute ergänzen Angaben zu diesen Elementen. Die verwendeten Namen und ihre Bedeutung legt die jeweilige Anwendung fest [9].
Das folgende Beispiel zeigt einen gekürzten und vereinfachten Ausschnitt aus dem Topic Wissen:
<topic template="Default" version="2"> <title>Wissen</title> <body> <header> <para styleclass="Heading1">Wissen</para> </header> <para styleclass="Body Text"> Wissen ermöglicht es Menschen, Zusammenhänge zu verstehen, Situationen einzuschätzen und begründet zu handeln. <snippet src="file::WM-SNIP-LVZ-0200.xml" inline="true"/> </para> </body> </topic> |
Die wichtigsten Bestandteile lassen sich daran wie folgt erklären:
Bestandteil |
Bedeutung im Beispiel |
|---|---|
Element |
<title>Wissen</title> besteht aus einem öffnenden Tag, dem Textinhalt und einem schliessenden Tag. |
Attribut |
styleclass="Body Text" weist dem Absatz eine Formatvorlage zu. Attributwerte stehen in Anführungszeichen. |
Verschachtelung |
<topic> umschliesst das Dokument. Darin liegen unter anderem <title> und <body>. Die untergeordneten Elemente bilden eine Hierarchie. |
Leeres Element |
<snippet .../> besitzt keinen eigenen Textinhalt. Seine Attribute verweisen auf die einzubindende Datei und legen die Einbindung im laufenden Text fest. |
Tabelle 2: Anforderungen an die persönliche Arbeitsumgebung.
Quelle: KI-gestützte Eigendarstellung.
Die Bezeichnungen topic, para oder snippet gehören zum XML-Format von Help+Manual. XML selbst schreibt diese Namen nicht vor. Auch version="2" ist eine Angabe des Autorensystems und bezeichnet nicht die Version der XML-Sprache.
XML verlangt eine genaue Schreibweise. Gross- und Kleinschreibung werden unterschieden, geöffnete Elemente müssen geschlossen und korrekt ineinander verschachtelt werden. Ein Dokument, das die grundlegenden XML-Syntaxregeln erfüllt, wird als wohlgeformt bezeichnet. Für die Verarbeitung durch Help+Manual muss zusätzlich die vom Autorensystem erwartete Dokumentstruktur eingehalten werden [8] [11].
Bestimmte Zeichen müssen im Text besonders geschrieben werden. Beispielsweise steht < für < und & für &. Der Variablenplatzhalter <%S\SP%> erscheint im gelieferten Quelltext deshalb als <%SSP%> innerhalb eines var-Elements. Einrückungen machen die Verschachtelung leichter lesbar, die Struktur entsteht durch die Elemente. Leerzeichen innerhalb von Textinhalten können dagegen für die Ausgabe relevant sein [8].
Für die Praxisfälle dieser Arbeit ermöglicht dieser Aufbau, bestimmte Elemente und Attribute gezielt zu finden und zu ändern. Externe Editoren und eigene Hilfsprogramme können solche Anpassungen über mehrere Topicdateien hinweg ausführen. Nach der Bearbeitung werden die Dateien im Autorensystem geöffnet und die betroffenen Ausgaben geprüft [11].
XML wurde entwickelt, um strukturierte Daten unabhängig von einzelnen Programmen und Plattformen über das Web austauschen und verarbeiten zu können. Es dient damit sowohl der Speicherung von Inhalten als auch dem Datenaustausch zwischen Systemen. Die eindeutig gekennzeichneten Elemente und Attribute ermöglichen eine maschinelle Verarbeitung und unterstützen automatisierte Prozesse. Ergänzende Technologien übernehmen dabei bestimmte Aufgaben: XML Schema definiert die zulässige Dokumentstruktur, XPath ermöglicht den gezielten Zugriff auf Elemente und Attribute, und XSLT beschreibt Regeln zur Umwandlung der Inhalte, beispielsweise in HTML oder andere XML-Strukturen. So lassen sich Daten automatisiert prüfen, weiterverarbeiten und aus einer gemeinsamen Inhaltsquelle unterschiedliche Ausgaben erzeugen. Dieses Zusammenspiel unterstützt die Trennung von Inhalt, Verarbeitung und Darstellung und bildet eine technische Grundlage für Single-Source-Publishing [8].
