Mit Arbortext Editor können Sie sowohl DITA-Maps als auch DITA-Topics veröffentlichen. Im Falle von DITA-Maps können Sie auch einen Teil der Map auswählen und nur diesen ausgewählten Teil veröffentlichen.

Für jeden DITA-Standarddokumenttyp ist eine Arbortext Styler Formatvorlage (.style) vorhanden. Sie können diese Formatvorlagen direkt oder als Grundlage für eigene erweiterte oder angepasste Formatvorlagen verwenden, mit denen Sie DITA-Dokumente veröffentlichen können. Die Beispiel-Formatvorlagen sind auch in einem modularen Format verfügbar. Die vorhandenen Module können Sie als Bausteine zur Entwicklung einer an Ihre Umgebung angepassten Formatvorlage verwenden. Weitere Informationen zur Entwicklung von Formatvorlagen für DITA-Dokumente finden Sie in der Online-Hilfe von Arbortext Styler.

Sie können DITA-Dokumente in den folgenden Formaten ausgeben:

Vor der Veröffentlichung können Sie Ihre DITA-Dokumente über Datei > Druckvorschau in einer Vorschau anzeigen. Die Arbortext Editor Funktion für die Zuweisung von Profilen und DITAVAL-Dateien gemäß DITA-Standard werden beide für DITA-Dokumente unterstützt, sodass Sie Inhalte in Ihren veröffentlichten Ausgaben filtern können.

Sie veröffentlichen DITA-Topics auf die gleiche Weise wie andere Dokumenttypen. Wenn Sie ein DITA-Topic mit Arbortext Editor oder Arbortext Publishing Engine veröffentlichen, wird das Topic gemäß der zugeordneten Formatvorlage im angegebenen Ausgabeformat veröffentlicht. Das Topic wird so veröffentlicht, als wäre es in einer DITA-Map enthalten. Auf diese Weise wird gewährleistet, dass Querverweise und Links korrekt aufgelöst werden. Das Veröffentlichen eines einzelnen Topic mit Querverweisen und Links führt normalerweise nicht zu dem gleichen Ergebnis wie das Veröffentlichen einer DITA-Map, die auf alle Topics verweist. Das Veröffentlichen von Topics bietet sich in der Regel für das Korrekturlesen und Überarbeiten an. Die Veröffentlichung sollte letztendlich immer von einer DITA-Map aus vorgenommen werden.

Eine DITA-Map ist eine Sammlung von Referenzen auf DITA-Topics und anderen Inhalt. Wenn Sie eine DITA-Map veröffentlichen, wird bei der Veröffentlichung zunächst der gesamte in der Map referenzierte Inhalt in ein Zwischendokument, das so genannte Komplettdokument für Formatierung, eingefügt. Das Komplettdokument wird dann auf Basis der zugeordneten Formatvorlage im angegebenen Ausgabeformat veröffentlicht. Wenn eine Map Verweise auf DITA- oder andere Dokumenttypen enthält, die sich nicht in der veröffentlichten Map befinden, werden bei der Veröffentlichung die Ziele dieser Verweise gesammelt, sodass diese Verweise in der Ausgabe ordnungsgemäß aufgelöst werden. Die referenzierten Dateien werden in einem Ordner gespeichert, dessen Name auf dem Ausgabedokument basiert. Dabei wird .ditaLinks an den Ordnernamen angefügt.

Eine Version des Komplettdokuments für Formatierung können Sie auch über die Arbortext Editor Menüoption Bearbeiten > Komplettdokument bearbeiten > Für Formatierung herstellen. Für diese Version des Komplettdokuments können Sie mit Arbortext Styler eine Formatvorlage für die Map entwickeln. Das Komplettdokument für Formatierung ist ein temporäres Dokument, das nur zur Formatvorlagenentwicklung dient. Im Gegensatz zum Komplettdokument für die Bearbeitung werden Änderungen im Komplettdokument für Formatierung beim Schließen des Komplettdokuments nicht in den zugeordneten Topics übernommen.

Für die Ausgabetypen EPUB, HTML-Hilfe und Web, für die mehrere HTML-Dateien generiert werden, wird bei der Veröffentlichung der Name der DITA-Eingabedateien und die Verzeichnisstruktur, in der sich die Eingabedateien befinden, standardmäßig beibehalten. Diese und andere Standardeinstellungen können in Arbortext Styler geändert werden.

Mit dem Profilattribut deliveryTarget für Topic-Referenzen (topicref-Elemente) in DITA-Maps und in Topics können Sie steuern, ob das referenzierte Topic oder der referenzierte Inhalt in einem bestimmten Ausgabetyp enthalten ist. In versendeten Dokumenttypen sind für das Attribut deliveryTarget die folgenden Werte zulässig:

Diese Werte ähneln jenen, die für das Attribut print, das seit DITA 1.3 veraltet ist, zulässig sind. Das Attribut print wird für DITA 1.3-Dokumente in Arbortext Editor weiterhin unterstützt.

Es wird empfohlen, dass für das Attribut deliveryTarget Werte festgelegt werden, die dem gewünschten Ausgabetyp entsprechen, z.B. epub, pdf oder html.

Falls Sie zu diesem Zweck deliveryTarget-Werte verwenden, müssen Sie den erforderlichen Wert während des Veröffentlichens als Profileinstellung auswählen.

Wenn eine Topic-Referenz weitere Topic-Referenzen enthält, steuert der Wert des Attributs deliveryTarget der übergeordneten Topic-Referenz, ob alle Topic-Referenzen in der angegebenen Ausgabe enthalten sein sollen oder nicht. Die Werte des Attributs deliveryTarget für die untergeordneten Topic-Referenzen werden in diesem Fall ignoriert.

Arbortext Editor unterstützt alle Schlüsselreferenzverarbeitungen, die im Abschnitt Processing key references der OASIS DITA Architectural Specification für die Veröffentlichung definiert sind. Das Ersetzen von Text während der Veröffentlichung wird sowohl durch Einfügen von Text in leere Elemente, die eine Schlüsseldefinition referenzieren, als auch mithilfe des Attributs conkeyref unterstützt.

Es kann vorkommen, dass ein conkeyref-Verweis keine Topic-ID aufweist. Dies ist beispielsweise der Fall, wenn die Schlüsseldefinition nur den URI des Topics enthält und die Content Reference auf den Schlüsselnamen und eine Element-ID im referenzierten Topic verweist. Das in der URI referenzierte Topic kann weitere Topics enthalten, entweder, weil es sich um eine Ditabase handelt, oder weil es verschachtelte Topics enthält, und diese Topics können Elemente mit derselben ID enthalten. In diesem Fall nimmt Arbortext Editor das erste Element mit der angegebenen ID im Topic als Ziel der Inhaltsreferenz an. Wenn das Topic mehrere Elemente mit derselben ID enthält, kann dies dazu führen, dass das falsche Element als Ziel der Inhaltsreferenz verwendet wird. Es wird empfohlen sicherzustellen, dass die Topic-ID in allen Schlüsseldefinitionen enthalten ist, die Sie für conkeyref-Verweise verwenden möchten.