XMetal Author Enterprise Edition

(Auszug aus "DITA - Der neue Standard für Technische Dokumentation" von Johannes Hentrich)

Unter den XML-Editoren gehört der XMetal-Editor von JustSystems Canada Inc. zu den „alten Hasen“, was die Bearbeitung von XML-Dateien betrifft. Mit zunehmender Popularität von DITA wurde der XMetal-Editor zunehmend zu einem DITA-Editor umgebaut. Die XMetal Author Enterprise Edition steht im Gegensatz zu vielen anderen XML-Editoren nur als Windows-Version zur Verfügung.

Die aktuelle Version der XMetal Author Enterprise Edition Version 5.1 ist vollständig auf DITA abgestimmt. Dabei wird auf die aktuelle Version von DITA Version 1.1 zurückgegriffen, das heißt, es werden Bookmaps, der Topictyp „Glossar“, die indexing-Domain usw. unterstützt.

Die XMetal Author Enterprise Edition bietet eine komfortable grafische Oberfläche zur Erstellung und Bearbeitung von XML-Dokumenten. Alle erlaubten Elemente werden abhängig von der Cursor-Position im Dokument auf der rechten Seite angezeigt, ebenso die Attribute, die für ein Element verwendet werden können.

Topic vom Typ „Konzept“ in XMetal Author Enterprise Edition

Abbildung: Ein Topic vom Typ „Konzept“ in der XMetal Author Enterprise Edition.

Für die Bearbeitung von Maps und Bookmaps steht ein Map-Editor zur Verfügung. Damit erweist sich insbesondere die Bearbeitung von Bookmaps als sehr einfach.

Eine leere Bookmap im Bookmap-Editor

Abbildung: Eine leere Bookmap im Bookmap-Editor.

In der XMetal Author Enterprise Edition ist das DITA Open Toolkit Version 1.4 komplett integriert. Bei der Installation werden die Dateien des DITA Open Toolkits und die Programmdateien in getrennten Verzeichnissen abgelegt. Bei einer Standardinstallation befinden sich die Dateien des DITA Open Toolkits im Verzeichnis C:/Programme/Gemeinsame Dateien/XMetal Shared/DITA_OT. Im Verzeichnis C:/Programme/Gemeinsame Dateien/XMetal Shared/ befinden sich weiterhin Dateien und Programme, die das DITA Open Toolkit benötigt, wie zum Beispiel Apache Ant, die Java Development Runtime Environment und den XSLT-Parser Saxon.

Durch die deutliche Trennung der Dateien des DITA Open Toolkits und der Programmdateien kann das DITA Open Toolkit ohne Weiteres aktualisiert werden. Gehen Sie dabei wie folgt vor:

  1. Laden Sie das vollständige Paket (full easy install package) des DITA Open Toolkits der neuen Version aus dem Internet herunter.
  2. Entpacken Sie die zip-Datei beispielsweise im Verzeichnis C:/Programme/Gemeinsame Dateien/XMetal Shared/.
  3. Wählen Sie danach in der XMetal Author Enterprise Edition im Menü Tools die Option Configure Output...
  4. Tragen Sie in der Registerkarte Advanced den Pfad zum neuen DITA Open Toolkit ein: DITA_OT_DIR = C:/Programme/Gemeinsame Dateien/XMetal Shared/DITA-OT1.4.2.1
    Nach dem nächsten Neustart der XMetal Author Enterprise Edition wird das neue DITA Open Toolkit verwendet.

Beachten Sie, dass die aktualisierte Version des DITA Open Toolkits nicht mehr das FO-Plugin zur Produktion von PDF-Dateien enthält. Sollen mittels der XMetal Author Enterprise Edition PDF-Dateien generiert werden, muss das FO-Plugin in der neuen Version des DITA Open Toolkits installiert werden. Informationen zur Installation des FO-Plugins erhalten Sie in DITA Open Toolkit.

Mit dem DITA Open Toolkit können mittels der XMetal Author Enterprise Edition folgende Ausgabemedien produziert werden:

  • Eclipse-Help
  • Microsoft HTML Help (CHM)
  • JavaHelp
  • HTML-Dateien
  • PDF-Dateien

Die Produktion von PDF-Dateien erfolgt über das FO-Plugin, das heißt, als XSL-FO-Formatierer wird die Personal Edition von RenderX verwendet. Der XMetal Author Enterprise Edition 5.1 User‘s Guide selbst ist mit DITA erstellt und mit der RenderX Desktop-Version produziert worden.

Die Anpassung der Stylesheets für die einzelnen Ausgabemedien erfolgt nicht in der XMetal Author Enterprise Edition, sondern direkt in den Dateien des DITA Open Toolkits selbst. Informationen zur Anpassung der Stylesheets finden Sie in DITA Open Toolkit.

Auch der Umgang mit Spezialisierungen stellt für die XMetal Author Enterprise Edition kein Problem dar. Dazu werden die DTDs und die Moduldateien zunächst spezialisiert, wie in Spezialisierung beschrieben. Danach müssen der XMetal Author Enterprise Edition die neuen DTDs und Moduldateien bekannt gemacht werden. Gehen Sie dabei wie folgt vor:

  1. Wählen Sie im Menü Tools die Option Select Specialized DITA.
  2. Wählen Sie im Dialogfenster die spezialisierte DTD aus. Danach wird ein weiteres Dialogfenster geöffnet, in dem Sie den Topictyp auswählen, zu dem die DTD spezialisiert wurde.
  3. Geben Sie in das Eingabefeld Specialized Public ID den öffentlichen Bezeichner der spezialisierten DTD ein. Nach einem Neustart der XMetal Author Enterprise Edition steht die spezialisierte DTD zur Verfügung.

Um in der XMetal Author Enterprise Edition die Erstellung neuer Dokumente mit der spezialisierten DTD zu ermöglichen, muss dazu ein neues Template angelegt werden. Gehen Sie dabei wie folgt vor:

  1. Wählen Sie im Menü File die Option New.
  2. Wählen Sie in der Registerkarte General die Option Blank XML Document.
  3. Wählen Sie im Dialogfenster die spezialisierte DTD aus.
  4. Fügen Sie alle Elemente und Attribute ein, die für das Template erforderlich sind.
  5. Speichern Sie das Dokument ab.
  6. Wählen Sie im Menü View die Option Plain Text.
  7. Entfernen Sie in der Document Type Declaration im Pfadnamen „_ditabase“.
  8. Ändern Sie in der Document Type Declaration das Schlüsselwort SYSTEM zu PUBLIC und fügen Sie den öffentlichen Bezeichner dem Schlüsselwort PUBLIC hinzu.
  9. Wählen Sie im Menü Tools die Option Macro...
  10. Wählen Sie das Makro DITA Configuration: Save Copy as Template.
  11. Speichern Sie die Datei mit einer Dateiendung wie .xml, .dita oder .dita-map und wählen Sie UTF-8 als Kodierung. Beim nächsten Neustart der XMetal Author Enterprise Edition können Sie DITA XML-Dokumente mit der spezialisierten DTD erstellen.

Die XMetal Author Enterprise Edition stellt einen konfigurierbaren Adapter zur Verfügung, über den mit praktisch allen gängigen Content-Management-Systemen und Systemen für die Versionskontrolle kommuniziert werden kann. Konfigurationsdateien für Adapter finden Sie bei einer Standardinstalltion der XMetal Author Enterprise Edition im C:/Programme/XMetaL 5.1/Author/CRCL/configs-Verzeichnis. Über das Menü Repository können Sie dann bei einer Anbindung an ein Content-Management-System zahlreiche Operationen ausführen, um DITA XML-Dateien aus dem Content-Management-System zu holen und dort wieder abzulegen.

  

<< zurück vor >>

 

 

 

Tipp der data2type-Redaktion:
Zum Thema DITA bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2008 XLcontent Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DITA - Der neue Standard für Technische Dokumentation" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

XLcontent Verlag, Pflegerstraße 40, 81247 München