StartseiteDITA-Veröffentlichung

DITA-Veröffentlichung

Erfahren Sie, wie Sie in FrameMaker die Veröffentlichungsprozesse zum Generieren von Ausgaben Ihrer DITA-Inhalte verwenden können.

In FrameMaker können Sie folgende Prozesse zum Generieren Ihrer DITA-Inhalte verwenden.

Speichern als PDF

Erfahren Sie, wie Sie mit der FrameMaker-Funktion „Als PDF speichern“ ein DITA-Topic oder eine DITA Map (einschließlich Bookmap) als PDF ausgeben.

Mit der FrameMaker-Funktion „Speichern als PDF“ können Sie ein DITA-Topic oder eine DITA Map (einschließlich Bookmap) als PDF ausgeben. Die erstellte PDF-Ausgabe verwendet die Anzeige der WYSIWYG-Ansicht. Dies bedeutet, dass die auf das Thema oder die Map angewendeten Formatierungsregeln der strukturierten Anwendung in der PDF ausgegeben werden.

Wählen Sie zum Erstellen einer PDF-Ausgabe eines DITA-Themas Datei > Als PDF speichern.

Wenn Sie die Funktion „Als PDF speichern“ zum Erstellen einer PDF-Ausgabe einer Karte verwenden, können Sie im Dialogfeld Dokument speichern die Option Aufforderung für DITAVAL-Datei wählen.

Sie können die DITAVAL-Funktion verwenden, um die Inhalte der Themen in der Map bedingt auszugeben. Ausführliche Informationen finden Sie unter DITAVAL.

Veröffentlichung auf mehreren Kanälen

Erfahren Sie, wie Sie mit der FrameMaker-Funktion zur Veröffentlichung auf mehreren Kanälen ein DITA-Topic oder eine DITA Map in verschiedenen Ausgabeformaten ausgeben.

Mit der FrameMaker-Funktion Multikanal-Publishing können Sie ein DITA-Topic oder eine DITA Map in folgenden Ausgabeformaten ausgeben:

DITA Open Toolkit

Lernen Sie das DITA Open Toolkit kennen und erfahren Sie, wie Sie in FrameMaker Ausgaben mit dem DITA Open Toolkit generieren können.

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 3.0 und 2.3. DITA-OT wandelt DITA-Inhalte (Maps und Topics) in lieferbare Formate um.

Standardmäßig können Sie Ihre DITA-Inhalte mit FrameMaker in folgenden Ausgabeformaten veröffentlichen:

  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 entsprechenden DITA-Datei im Fokus wählen Sie Struktur > DITA > DITA-OT-Ausgabe generieren-

    Das Dialogfeld DITA-OT-Ausgabe generieren wird angezeigt.

    Dialogfeld „DITA-OT-Ausgabe generieren“
    Dialogfeld „DITA-OT-Ausgabe generieren“ in FrameMaker

  2. Wählen Sie einen Ausgabetyp.

  3. Wählen Sie Protokolldatei anzeigen, wenn Sie die Protokolldatei starten möchten, nachdem die Veröffentlichung abgeschlossen wurde.

    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 offen zu lassen, auch nachdem die Veröffentlichung abgeschlossen ist.

  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 an beiden Speicherorten (ditafm.ini und „DITA-OT-Ausgabe generieren“) eine DITAVAL-Datei angeben, hat die im Dialogfeld „DITA-OT-Ausgabe generieren“ ausgewä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.

Important: 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 im aktuellen AppData-Ordner: %appdata%\Adobe\FrameMaker\xx\ditafm.ini

  2. Suchen Sie in der Datei folgenden Text:

    Count=3
    1=xhtml
    2=htmlhelp
    3=pdf
    Hinweis: Die obige nummerierte Liste 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 die Anzahl als 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 im AppData-Ordner des aktuellen Benutzers:

    %appdata%\Adobe\FrameMaker\xx\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 zeigt.

    Beispielsweise C:\DITA-OT_3.1.2.

  4. Starten Sie FrameMaker neu.

    Der neue DITA OT-Pfad wird im Dialogfeld DITA-Ausgabe erzeugen ausgefüllt.

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

  1. Wählen Sie Struktur > DITA > DITA-OT-Ausgabe generieren, um das Dialogfeld DITA-OT-Ausgabe generieren zu öffnen.

  2. Klicken Sie auf die Schaltfläche Anpassen, um das Dialogfeld DITA-OT anpassen zu öffnen.

    Dialogfeld „DITA-OT anpassen“
    Dialogfeld „DITA-OT anpassen“ in FrameMaker
  3. Geben Sie die folgenden Informationen über dieses Dialogfeld an:

    DITA-OT-Ordner

    Geben Sie den Pfad an, an dem die benutzerdefinierte DITA-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 Skriptdatei build.xml für die ANT-Erstellung 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.