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.1. 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.)
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)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 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. In diesem Fall ist es nicht erforderlich, jedes Mal eine DitaVal-Datei auszuwählen, wenn Sie die Ausgabe generieren.
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.
5)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
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
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
•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
DitaDir=%FMHOME%\fminit\ditafm\DITA-OT
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
DITA Open Toolkit 2.1 ist in FrameMaker integriert. Wenn Sie bereits eine andere Version von DITA Open Toolkit installiert haben, können Sie den DITA Open Toolkit-Pfad durch Bearbeiten der DITA-Initialisierungsdatei 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-Verzeichnisses:
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.