DITA Open Toolkit

Das DITA Open Toolkit (DITA OT) ist eine Zusammenstellung von Java-basierten Open-Source-Tools, die der Verarbeitung von DITA Map- und DITA-Topic Inhalten dienen. FrameMaker verfügt über eine einsatzbereite Unterstützung für DITA Open Toolkit 2.3. DITA-OT wandelt DITA-Inhalte (Zuordnungen und Themen) in lieferbare Formate um.

Standardmäßig können Sie Ihre DITA-Inhalte mit FrameMaker in folgenden drei Formaten ausgeben:

1)PDF2

2)XHTML

3)CHM (Installieren Sie HTML Help Workshop, um CHM zu generieren.)

4)Benutzerdefiniert

Sie können auch eine Ausgabe für Formate wie DocBook, JavaHelp und RTF generieren. Weitere Informationen zum Aktivieren anderer Ausgabeformate finden Sie unter Ausgabetypliste ändern.

Generieren von Ausgaben mit DITA OT

1)Mit der richtigen DITA-Datei im Fokus wählen Sie „DITA“ > „DITA-OT-Ausgabe generieren“.

Das Dialogfeld „DITA-OT generieren“ wird angezeigt.

Dialogfeld „DITA-OT-Ausgabe generieren“

2)Wählen Sie einen Ausgabetyp.

3)Wählen Sie „Protokolldatei anzeigen“, wenn Sie die Protokolldatei starten möchten, nachdem Sie die Veröffentlichung abgeschlossen haben.

Standardmäßig wird das DITA OT beim Installieren von FrameMaker installiert. Wenn Sie das Toolkit jedoch separat installiert haben, können Sie im Feld „DITA-OT-Ordner“ das Installationsverzeichnis angeben. Die Änderung an diesem Feld gilt nur für die aktuelle Ausgabe. Beim nächsten Öffnen des Dialogfelds „DITA-OT-Ausgabe generieren“ wird das Verzeichnis auf die FrameMaker-Standardeinstellung zurückgesetzt. Weitere Informationen zum Ändern des Standardverzeichnisses finden Sie unter Anderes DITA-OT-Ausgabepaket verwenden.

4)Wählen Sie die Option „Ausgabeordner öffnen“, um den Ausgabeordner in Windows Explorer zu öffnen. Der Ausgabeordner wird in Windows Explorer nach dem Abschluss der Veröffentlichung angezeigt.

5)Wählen Sie „Dialog nach Erstellung geöffnet lassen“, um dieses Dialogfeld, selbst nachdem die Veröffentlichung abgeschlossen ist, geöffnet zu lassen.

6)Wählen Sie eine DITAVAL-Datei, um die Bedingungsfilter von Inhalten mit den Attributwertpaaren anzugeben, die in der DitaVal-Datei definiert werden. Weitere Informationen zur Verwendung von DITAVAL-Dateien finden Sie unter DITAVAL.

Wenn Sie die gleiche DitaVal-Datei verwenden möchten, wenn Sie mehrere Dokumente generieren, können Sie den Dateinamen und Speicherort unter ditafm.ini angeben. Dann müssen Sie beim Generieren der Ausgabe nicht jedes Mal eine DITAVAL-Datei auswählen.

hinweis: Wenn Sie in beiden Speicherorten (ditafm.ini und Dialogfeld „DITA-OT generieren“) eine DITAVAL-Datei angeben, hat die in „DITA-OT generieren“ gewählte Datei den Vorrang.

7)Klicken Sie auf „Erstellen“.

FrameMaker ruft DITA OT auf und generiert die Ausgabe im selben Ordner, in dem sich das Quellthema oder die Quell-Map befindet.

Ausgabetypliste ändern

Standardmäßig können Sie mit FrameMaker das DITA OT verwenden, um Ausgaben für PDF2, XHTML und HTML-Hilfe erstellen. Sie können jedoch das Toolkit verwenden, um Ausgaben für eine Reihe anderer Formate zu erstellen. Zum Generieren von Ausgaben in anderen Formaten müssen Sie die Datei „ditafm.ini“ aktualisieren.

wichtig: Die folgende Prozedur erfordert Änderungen an der Datei „ditafm.ini“. Bevor Sie Änderungen vornehmen, wird empfohlen, dass Sie eine Sicherung dieser Datei durchführen.

1)Öffnen Sie die Datei „ditafm.ini“. (<FrameMaker-Installationspfad>\fminit\ditafm\ditafm.ini)

2)Suchen Sie in der Datei folgenden Text:

Count=3
1=xhtml
2=htmlhelp
3=pdf2

hinweis: Die nummerierte Liste oben entspricht der im Dialogfeld „DITA-OT-Ausgabe generieren“ verfügbaren Liste der Ausgabeformate.

3)Um im Dialogfeld „DITA-OT-Ausgabe generieren“ Ausgabetypen hinzufügen oder entfernen zu können, müssen Sie unter „Anzahl“ die Anzahl der in der Liste anzuzeigenden Typen angeben.

4)Die folgende Liste ist die Liste aller verfügbaren Ausgabetypen, die Sie einschließen können. Um einen oder mehrere dieser Ausgabetypen einschließen zu können, müssen Sie diese der nummerierten Liste hinzufügen und sicherstellen, dass die Reihenfolge der Nummerierung erhalten bleibt:

•docbook

•eclipsecontent

•eclipsehelp

•htmlhelp

•javahelp

•net.sourceforge

•html

•odt

•pdf

•tocjs

•troff

•wordrtf

•xhtml

hinweis: Bei den Ausgabetypeinträgen in der Datei ditafm.ini wird Groß- und Kleinschreibung unterschieden. Sie müssen die Einträge wie in der Liste oben angegeben erstellen.

Im folgenden Beispiel werden die Formate EclipseHelp und Word-RTF der vorhandenen Liste hinzugefügt.

Count=5
1=xhtml
2=htmlhelp
3=pdf2
4=eclipsehelp
5=wordrtf

hinweis: Sie können die Liste vollständig ändern und eine beliebige Zusammenstellung von Ausgabetypen darin aufnehmen.

5)Starten Sie FrameMaker neu, damit die Änderungen wirksam werden.

Anderes DITA-OT-Ausgabepaket verwenden

FrameMaker beinhaltet DITA Open Toolkit 2.3. Wenn Sie bereits eine andere Version von DITA Open Toolkit installiert haben, können Sie den DITA Open Toolkit-Pfad entweder durch Bearbeiten der DITA-Initialisierungsdatei oder im Dialog „DITA-OT anpassen“ anpassen.

In einer einmaligen Änderung können Sie beim Generieren der Ausgabe mit dem DITA Open Toolkit den Verzeichnispfad ändern.

Ändern des standardmäßigen FrameMaker-DITA-OT-Ordners über die DITA-Initialisierungsdatei:

1)Öffnen Sie die Datei „ditafm.ini“. (<FrameMaker-Installationspfad>\fminit\ditafm\ditafm.ini)

2)Suchen Sie in der Datei folgenden Text:

DitaDir=%FMHOME%\fminit\ditafm\DITA-OT

3)Ändern Sie den Wert von „DitaDir“ so, dass er auf den alternativen DITA-OT-Ordner verweist.

Zum Beispiel: c:\DITA-OT1.7.5_standard_bin.

4)Starten Sie FrameMaker neu.

Der neue Pfad „DITA OT“ im Dialog „DITA - Ausgabe erzeugen“ ist ausgefüllt.

Ändern des standardmäßigen FrameMaker-DITA-OT-Ordners über das Dialogfeld „DITA-OT anpassen“:

1)Öffnen Sie das Dialogfeld „DITA-OT-Ausgabe generieren“ („Struktur“ > „DITA“> „DITA-OT Ausgabe generieren“).

2)Klicken Sie auf „Anpassen“, um das Dialogfeld „DITA-OT anpassen“ zu öffnen.

3)Geben Sie die folgenden Informationen über dieses Dialogfeld an:

DITA-OT-Ordner

Geben Sie den Pfad an, an dem die benutzerdefinierteDITA-OT.zip-Datei gespeichert wird. Sie können die Variable %FMHOME%, die auf den FrameMaker-Speicherort verweist. Dieser Pfad wird in der DITA_DIR-Variable gespeichert, die verwendet werden kann, um den Pfad von anderen verwandte Ordnern anzugeben.

Ant-Befehl

Geben Sie den Pfad des Ant-Skript-Ordners an. Dieser Pfad ist relativ zum DITA-OT-Ordner in Ihrem Dateisystem.

Ant-Start

Geben Sie den Pfad des ANT-Installationsordners an.

Klassenpfad

Geben Sie den Pfad der Java-Bibliotheken an.

Erstellungsdatei

Geben Sie den Pfad der ANT-Erstellungsskriptdatei - build.xml an. Dieser Pfad ist relativ zum DITA-OT-Ordner.

Zusätzliche Parameter

Geben Sie etwaige zusätzliche Parameter an, die in Ihrem benutzerdefinierten DITA-OT-Plug-In erforderlich sind.