Erstellen strukturierter Inhalte

Erfahren Sie, wie Sie in strukturiertem FrameMaker Inhalte erstellen können.

Sie können ein strukturiertes Dokument als strukturierte XML-Dokumente oder als .fm-Dokumente erstellen.

Strukturiertes Authoring basiert auf Elementen. Ein Element in einem Dokument enthält Text-, Bild- oder andere Elemente. Ein strukturiertes Dokument besteht aus einer Hierarchie von Elemente.

Elementhierarchie
Hierarchie der Elemente in einem strukturierten Dokument

Welche Elemente in einem strukturierten Dokument enthalten sind, hängt von der strukturierten Anwendung ab, auf der das Dokument basiert. Die strukturierte Anwendung definiert die strukturellen Regeln und Formatierungsregeln, die von den auf ihr basierenden Dokumenten verwendet werden. Ausführliche Informationen finden Sie unter Erste Schritte mit strukturierten Anwendungen.

Beim Erstellen eines strukturierten Dokuments in FrameMaker müssen Sie angeben, welche strukturierte Anwendung verwendet werden soll.

Erstellen von XML-Dokumenten

Sie können ein leeres XML-Dokument erstellen, das nicht auf einer strukturierten Anwendung basiert.

Außerdem können Sie ein XML-Dokument erstellen, das auf einer vorhandenen DTD (Document Type Definition) basiert.

Sie können strukturierte XML-Dokumente erstellen, die auf einer strukturierten Anwendung basieren.

Erstellen von leeren XML-Dokumenten

Sie können ein leeres XML-Dokument vollkommen neu erstellen. Dieses Dokument enthält nur ein einzelnes Stammelement (<ROOT>).

  1. Öffnen Sie das Dialogfeld Neue XML-Datei (Datei > Neu > XML).

  2. Wählen Sie in der Registerkarte Sonstige XML die Option Leere XML-Datei, und klicken Sie auf OK.

  3. Öffnen Sie den Katalog Elemente, um die Liste der Elemente im Katalog anzuzeigen (Ansicht > Pods > Elementkatalog).

    Hinweis: Der Katalog Elemente enthält ein Element <TEXT> und ein Element <ROOT>.

In der WYSIWYG-Ansicht können Sie nur ROOT-Elemente oder Text in den Stammelementen hinzufügen.<>

In der XML-Ansicht können Sie Elemente zur XML-Struktur hinzufügen. Sie können beispielsweise ein Element <ABSCHNITT> und ein Element <P> innerhalb eines <ROOT>-Elements hinzfügen:

In XML-Ansicht hinzugefügtes p-Element
Hinzufügen eines p-Elements in der XML-Ansicht

Der KatalogElemente in der Ansicht WYSIWYG zeigt jetzt die Elemente <ABSCHNITT> und <P> an. Jetzt können Sie dieses Element im XML-Dokument hinzufügen. Da dieses Dokument nicht auf einer strukturierten Anwendung basiert, setzt FrameMaker für das Dokument keine strukturellen Regeln durch. FrameMaker stellt jedoch sicher, dass die Struktur der XML-Datei beibehalten wird.

Erstellen eines DTD-basierten XML-Dokuments

Sie können ein XML-Dokument auf der Grundlage einer vorhandenen DTD (Document Type Definition) erstellen.

  1. Speichern Sie den folgenden Textausschnitt in einer Textdatei.

    <!ELEMENT BOOK (CHAPTER+)> 
<!ELEMENT CHAPTER (HEADLINE,BODY)> 
<!ELEMENT HEADLINE (#PCDATA)>
<!ELEMENT BODY (#PCDATA)> 
<!ATTLIST CHAPTER AUTHOR CDATA #REQUIRED>

  2. Speichern Sie die Textdatei mit der Erweiterung .dtd.

  3. Öffnen Sie das Dialogfeld Neue XML-Datei (Datei > Neu > XML).

  4. Wählen Sie in der Registerkarte Sonstige XML die DTD-basierte XML-Datei aus, und klicken Sie auf OK.

  5. Im Dialogfeld Neue XML-Datei:

    Stammelement

    Geben Sie den Namen für das Stammelement des XML-Dokuments an. Dies ist das oberste Element in der Hierarchie.

    Öffentliche ID

    Mithilfe einer öffentlichen ID in einem XML-Dokument kann dieses auf andere Computer übertragen werden.

    System-ID

    Pfad zur DTD. Dies kann ein Pfad im Dateisystem oder eine URL sein.

    Hinweis: Beim Anzeigen des Dokuments in der XML-Ansicht werden die öffentliche ID und die System-ID in der DOCTYPE-Deklaration am Anfang der Datei gespeichert.

  6. Klicken Sie auf „OK“.

    Die Elemente <TEXTKÖRPER>, <KAPITEL> und <ÜBERSCHRIFT>, die in der DTD definiert sind, sind im Katalog Elemente verfügbar.

  7. Fügen Sie das <KAPITEL>-Element in das Dokument ein.

    Im Dialogfeld „Attribute für neues Element“ werden Sie aufgefordert, den Wert des Attributs AUTOR einzugeben.

Erstellen eines XML-Dokuments auf der Grundlage einer strukturierten Anwendung

Eine strukturierte Anwendung definiert strukturelle Regeln (mithilfe von EDD oder DTD), Inhaltsformatierung (mithilfe von Vorlagen) und Lese-/Schreibregeln für auf der Anwendung basierende Dokumente. FrameMaker verfügt über einen Satz von einsatzbereiten strukturierten Anwendungen, mit denen Sie Dokumente erstellen können. Diese Anwendungen basieren auf den folgenden offenen Standards:

DITA

DITA (Darwin Information Typing Architecture) bietet eine standardmäßige DTD und einen Satz von Regeln speziell zum Schreiben von Onlinedokumentation wie Software-Hilfedateien. Es wird eine Tag-Struktur definiert, die für Authoring, Erstellen und Liefern technischer Dokumentation geeignet ist. Die Typen von Tags in DITA beinhalten <topic>, <title>, <shortdesc>, <prolog>, <body> und <concept>.

xDocBook

DocBook ist ebenfalls ein offener Standard, der für technische Artikel und Dokumentation entwickelt wurde. DocBook enthält eine DTD zum Schreiben von technischen Büchern und Artikeln in einem entsprechenden Format. DocBook-Tags beinhalten <article>, <section>, <title>, <articleinfo> und <pubdate>.

XHTML

Extensible Hypertext Markup Language (XHTML) ist eine auf XML basierende Erweiterung von HTML, die für die Arbeit mit XML-basierten Anwendungen entwickelt wurde. Sie kann mit Standard-XML-Werkzeugen angezeigt, bearbeitet und geprüft werden. Die Verwendung von XHTML ist eine einfache Art der Migrierung von HTML zu XML, wobei die Kompatibilität in beide Richtungen gewahrt wird.

S1000D

Aus Leistungsgründen führt FrameMaker die zugeordneten S1000D-Skripte beim Start nicht aus. Deshalb müssen Sie die folgenden Schritte ausführen, bevor Sie auf S1000D-Anwendungen basierende Dokumente erstellen:

  1. Bearbeiten > Voreinstellungen zum Öffnen des Dialogfelds Voreinstellungen.

  2. Wechseln Sie zur Registerkarte Allgemein > Starten, und entfernen Sie die folgenden Einträge aus dem Feld „Startskripte nicht laden“:

    S1000dUtilities und S1000Dmenu

  3. Klicken Sie auf OK und starten Sie FrameMaker neu.

Hinweis: Weitere Informationen zu S1000D finden Sie unter Adobe FrameMaker (Version 2017) – Anwendungspaket für S1000D.

Darüber hinaus können Sie eine eigene strukturierte Anwendung erstellen. Anschließend können Sie Dokumente auf der Grundlage dieser Anwendung erstellen.

  1. Wählen Sie Datei > Neu > XML, um das Dialogfeld Neue XML-Datei zu öffnen.

  2. Wählen Sie eine strukturierte Anwendung in der Registerkarte Strukturierte Anwendungen, oder wählen Sie eine strukturierte DITA-Anwendung in der DITA-Registerkarte aus.

    Hinweis: Die strukturierten DITA-Anwendungen sind auch auf der Registerkarte „Strukturierte Anwendungen“ verfügbar.

  3. Klicken Sie auf „OK“.

Welche Elemente im Elementkatalog enthalten und welche Attribute für die einzelnen Elemente definiert sind, hängt von der strukturierten Anwendung ab, auf der das Dokument basiert.

Da strukturierte Dokumente Strukturregeln erzwingen, basieren die Elemente im Katalog Elemente auf dem aktuellen Kontext.

Speichern von XML-Dokumenten

Wenn beim Speichern von XML-Dokumenten das folgende Dialogfeld angezeigt wird, müssen Sie die zugeordnete strukturierte Anwendung auswählen.

Strukturierte Anwendung wählen
Auswählen der zugeordneten strukturierten Anwendung beim Speichern eines XML-Dokuments:

Wenn Sie eine inkompatible strukturierte Anwendung wählen, werden die Fehler in der Meldungskonsole protokolliert.

Beim Öffnen eines strukturierten Dokuments zeigt die FrameMaker-Fehlerkonsole strukturelle und andere Probleme in einem Dokument an. Diese Konsole beinhaltet außerdem folgende Informationen zu Fehlern in Dokumenten:

  • Genaue Stelle der Fehler im Dokument

  • Name der ungültigen Elemente (falls vorhanden)

Öffnen von XML-Dokumenten

Wenn beim Öffnen von XML-Dokumenten das folgende Dialogfeld angezeigt wird, müssen Sie die zugeordnete strukturierte Anwendung auswählen.

Strukturierte Anwendung wählen
Auswählen der zugeordneten strukturierten Anwendung beim Öffnen eines XML-Dokuments:

Wenn Sie eine inkompatible strukturierte Anwendung wählen, werden die Fehler in der Fehlerkonsole protokolliert. Außerdem wird das Dokument in der Strukturansicht mit Fehlern angezeigt, wenn die Hierarchie des XML-Dokuments nicht den in der Anwendung definierten Strukturregeln entspricht.

Arbeiten mit Elementen

Lernen Sie in FrameMaker die verschiedenen Elemente im strukturierten Authoring kennen und arbeiten Sie mit ihnen, lernen Sie den Elementkatalog kennen, und erfahren Sie, wie Sie Elemente verwalten.

Welche Elemente in einem strukturierten Dokument enthalten sind, hängt von der strukturierten Anwendung ab, auf der das Dokument basiert. Beim Erstellen eines strukturierten Dokuments wird der Katalog Elemente für das Dokument mit den in der Anwendung definierten Elementen aufgefüllt

Elementkatalog

Sie können die in der zugeordneten strukturierten Anwendung definierten Elemente im Elementkatalog anzeigen und mit ihnen arbeiten.

Um den Katalog Elemente für das aktuelle Dokument zu öffnen, wählen Sie Ansicht > Pods > Elementkatalog.

Pod „Elemente“
Pod „Elemente“ in FrameMaker

Um die Struktur des Dokuments aufrechtzuerhalten, werden im Elementkatalog nur gültige Elemente angezeigt. Dies bedeutet, dass der Katalog nur Elemente anzeigt,

  • die in der zugeordneten strukturierten Anwendung definiert sind,

  • gültig an der aktuellen Stelle

    Angenommen, eine strukturierte Anwendung definiert ein <Tabellen>-Element, welches <Zeilen>-Elemente enthält Wird nur dann im Elementkatalog angezeigt, wenn die Einfügemarke an der entsprechenden Position im <>Tabellen<>element platziert wird.

    Anzeige gültiger Zeilenelemente im Elementkatalog
    Anzeige gültiger Zeilenelemente im Elementkatalog

Verwenden Sie den Elementkatalog für die folgenden Vorgänge:

Einfügen

Fügen Sie ein Element in die Dokumenthierarchie ein. Weitere Informationen finden Sie unter Einfügen von Elementen.

Eingliedern

Sie können das Format von Inhalten innerhalb eines vorhandenen Elements ändern. Sie können beispielsweise ein oder mehrere Wörter im Absatz fett formatieren. Da strukturierte Dokumente auf Elementen basieren, muss die strukturierte Anwendung die betreffenden Wörter in ein entsprechendes Element einschließen. Weitere Informationen finden Sie unter Eingliedern von Elementen

Änderung

Sie können das einschließende Element in der Hierarchie ändern. Sie können beispielsweise einen Absatz (<p>) in eine Notiz (<note>) ändern. Weitere Informationen finden Sie unter Ändern von Elementen.

Optionen

Sie können die Anzeige der Elemente im Elementkatalog mithilfe der Optionen im Dialogfeld „Verfügbare Elemente zuweisen“ anpassen. Weitere Informationen finden Sie unter Konfigurieren des Elementkatalogs.

Einfügen von Elementen

  1. Platzieren Sie die Einfügemarke an einer Position in der Dokumenthierarchie.

  2. Wählen Sie das erforderliche Element im Katalog Elemente aus.

  3. Klicken Sie auf Einfügen, um das Element in die Dokumenthierarchie einzufügen.

  4. Wenn das Dialogfeld Attribute für neues Element angezeigt wird, geben Sie die erforderlichen Attribute an und klicken Sie auf Element einfügen.

    Sie können auch später auf Element einfügen klicken und Attribute angeben. Weitere Informationen zu Attributen von Elementen in einem Dokument finden Sie unter Arbeiten mit Attributen.

Hinweis: Sie können auch einfach im Dialogfeld auf ein Element doppelklicken, um es einzufügen.

Wenn es sich um ein textbasiertes Element (Absatz oder Notiz) handelt, können Sie mit der Eingabe in das Dokument beginnen. FrameMaker stellt sicher, dass der Text innerhalb der Elementgrenzen eingefügt wird.

Wenn es sich um ein bildbasiertes Element handelt, wird das Dialogfeld für die Dateiauswahl angezeigt.

Wenn es sich um ein tabellenbasiertes Element handelt, wird das Dialogfeld „Tabelle einfügen“ angezeigt.

Hinweis: Die Dialogfelder für die Dateiauswahl oder für Tabelle einfügen werden nur angezeigt, wenn die Funktionalität zum Anzeigen der Dialogfelder in der strukturierten Anwendung implementiert sind, auf der das aktuelle Dokument basiert.

Mithilfe der Optionen im Dialogfeld Neue Elementoptionen (Elemente > Neue Elementoptionen) können Sie ändern, wie FrameMaker funktioniert, wenn Sie ein Element in die Hierarchie einfügen:

Attributwerte immer anfordern

Zeigen Sie das Dialogfeld Attribute für neues Element jedes Mal an, wenn Sie ein Element in das Dokument einfügen.

Benötigte Attributwerte anfordern

Das Dialogfeld wird nur angezeigt, wenn die zugeordnete strukturierte Anwendung obligatorische Attributwerte für ein Element festlegt. Wenn Sie die Werten nicht angeben, wird die Struktur des Dokuments beschädigt. Sie können die Werte jedoch zu einem späteren Zeitpunkt angeben.

Benötigte Attributwerte nicht anfordern

Das Dialogfeld wird nicht angezeigt, wenn Sie ein neues Element in die Hierarchie einfügen.

Automatisches Einfügen von untergeordneten Elementen zulassen

Wenn ein Element untergeordnete Elemente enthält, werden die untergeordneten Elemente beim Einfügen des übergeordneten Elements mit eingefügt.

Welche untergeordneten Elemente zusammen mit dem übergeordneten Element eingefügt werden, hängt von den in der zugeordneten strukturierten Anwendung definierten Regeln ab. Wenn Sie beispielsweise in einem DITA-Topic ein Element „geordnete Liste“ (<ol>) einfügen, wird ebenfalls ein Element „Listenelement“ (<li>) eingefügt. Bei deaktivierter Option wird ein leeres ol-Element eingefügt.

Regel für automatisches Einfügen rekursiv verarbeiten

Wenn ein Element nachfolgende Elemente enthält (d. h. untergeordnete Elemente, die wiederum untergeordnete Elemente enthalten), werden alle nachfolgenden Elemente beim Einfügen des übergeordneten Elements mit eingefügt.

Welche nachfolgenden Elemente zusammen mit dem übergeordneten Element eingefügt werden, hängt von den in der zugeordneten strukturierten Anwendung definierten Regeln ab. Wenn Sie beispielsweise in einem DITA-Topic ein Element „geordnete Liste“ (ol) einfügen, wird ebenfalls ein Element „Listenelement“ (li) eingefügt. Innerhalb des Listenelements wird wiederum ein Absatzelement eingefügt. Bei deaktivierter Option wird ein ol-Element zusammen mit dem li-Element eingefügt.

Tastaturbefehl zum Einfügen von Elementen

  1. Drücken Sie Strg+1, um den Smart-Katalog gültiger Elemente anzuzeigen.

  2. Wählen Sie im Smart-Katalog das erforderliche Element aus, und drücken Sie die Eingabetaste.

Eingliedern von Elementen

  1. Wählen Sie den Inhalt aus, und klicken Sie im Katalog Elemente auf das Element (zum Eingliedern).

  2. Klicken Sie auf Eingliedern, um den ausgewählten Inhalt innerhalb der Elementgrenzen einzuschließen.

Hinweis: Wenn Sie sicher sind, dass es sich bei dem im Dialogfeld ausgewählten Element um ein formatbasiertes Element, z. B. Fett- oder Kursivformatierung, handelt, können Sie auch einfach darauf doppelklicken. Wenn es sich jedoch nicht um ein formatbasiertes Element handelt, versucht FrameMaker, das Element (z. B. eine Tabelle) an der ausgewählten Position einzufügen. In der Strukturansicht können Sie die Gültigkeit des strukturierten Dokuments überprüfen.

Tastaturbefehl zum Eingliedern von Elementen

  1. Wählen Sie im Dokument das Element, auf das Sie ein Format anwenden möchten.

  2. Drücken Sie Strg+2, um den Smart-Katalog gültiger Elemente anzuzeigen.

  3. Wählen Sie im Smart-Katalog das erforderliche Element aus, und drücken Sie die Eingabetaste.

Ändern von Elementen

  1. Wählen Sie das zu ändernde Element im Pod Strukturansicht aus.

  2. Wählen Sie das zu ändernde Element im Katalog Elemente aus, und klicken Sie auf Ändern.

Hinweis: FrameMaker ändert das Element nach Möglichkeit.

Tastaturbefehl zum Ändern von Elementen

  1. Wählen Sie das zu ändernde Element im Dokument.

  2. Drücken Sie Strg+3, um den Smart-Katalog gültiger Elemente anzuzeigen.

  3. Wählen Sie im Smart-Katalog das erforderliche Element aus, und drücken Sie die Eingabetaste.

Konfigurieren des Elementkatalogs

Klicken Sie auf „Optionen“, um das Dialogfeld zu öffnen, um folgende Aufgaben auszuführen:

Gültige nachgeordnete Elemente (Standardreihenfolge)

Nur die an der aktuellen Einfügemarke in der Hierarchie gültigen Elemente werden angezeigt. Die Reihenfolge der Elemente im Pod entspricht der Definition in der strukturierten Anwendung.

Wählen Sie diese Option, wenn Sie ein Dokument komplett fertigstellen und Elemente in der richtigen Reihenfolge und Hierarchie einfügen möchten.

Gültige nachgeordnete Elemente (beliebige Reihenfolge)

Nur die an der aktuellen Einfügemarke in der Hierarchie gültigen Elemente werden angezeigt.

Wählen Sie diese Einstellung, wenn Sie ein gültiges Dokument aufbauen, jedoch nicht komplett fertigstellen möchten. Diese Einstellung empfiehlt sich besonders, wenn Sie nicht alle erforderlichen Informationen haben.

Alle zugelassenen nachgeordneten Elemente

Alle für das aktuelle übergeordnete Element gültigen Elemente werden angezeigt.

Wählen Sie diese Option, wenn Sie mehr Flexibilität beim Einfügen von Elementen benötigen. Sie können ungültige Elemente einfügen und die Fehler später berichtigen.

Alle Elemente

Zeigt alle im Katalog Elemente verfügbaren Elemente an, welche in der strukturierten Anwendung definiert sind. Die an einer Einfügemarke gültigen Elemente werden jedoch durch ein Häkchen gekennzeichnet.

Wählen Sie diese Option in den folgenden Fällen:

  • Sie erstellen gerade kein gültiges Dokument.

  • Sie benötigen Flexibilität und korrigieren Fehler später.

  • Sie möchten Inhalte in Elemente eingliedern.

  • Sie möchten sehen, was an anderen Stellen im Dokument verfügbar ist.

Häkchen an gültigen Elementen
Häkchen an gültigen Elementen im Pod „Elemente“

Angepasste Liste

Klicken Sie auf „Bearbeiten“, um das Dialogfeld „Spezielle Liste verfügbarer Elemente“ zu öffnen. Anschließend können Sie wählen, welche Elemente ein- bzw. ausgeblendet werden sollen. Verwenden Sie die Schaltflächen Nach oben und Nach unten, um die Reihenfolge festzulegen, in der die Elemente im Pod angezeigt werden.

Wählen Sie diese Option für Folgendes:

  • Arbeiten mit einer vordefinierten Teilmenge der Elemente

  • Anzeigen von Elementen in einer bestimmten Reihenfolge

  • Arbeiten mit einer statischen, nicht kontextspezifischen Elementliste

Wichtig: Dies ist eine feste Liste, d. h., die Liste enthält nicht auch die an der aktuellen Einfügemarke gültigen Elemente, es sei denn, Sie haben diese Elemente beim Erstellen der Liste ausgewählt.
Elementbeschreibungstags einblenden

Die Beschreibung eines Element wird rechts neben dem Element in Klammern angezeigt.

Nach anderen gültigen Elementen auflisten

Je nachdem, welche Optionen Sie oben ausgewählt haben, enthält der Pod möglicherweise Elemente, die an der angegebenen Position ungültig sind. Wählen Sie diese Option, um zuerst gültige Elemente anzuzeigen, gefolgt von ungültigen Elementen.

Verwalten von Elementen

Beim Arbeiten mit Elementen in einem Dokument verwenden Sie den Elementkatalog, um die Elemente einzufügen, einzugliedern und zu ändern. Sie können jedoch auch mehrere Elemente in einem Dokument zusammenfügen, ein einzelnes Element in mehrere Elemente teilen sowie Elemente in einem Dokument ausgliedern.

Zusammenfügen von Elementen

Sie können mehrere ähnliche und nebeneinander liegende Elemente in einem Dokument zusammenfügen. Beispiele: Sie können zwei oder mehr p-Tags zusammenfügen, um die Inhalte in einem p-Tag zusammenzufassen. Sie können auch mehrere (geordnete oder ungeordnete) Listen zusammenfügen, um die Elemente aus den verschiedenen Listen in einer Liste zusammenzufassen.

  1. Um im Pod Strukturansicht mehrere ähnliche Elemente auszuwählen, klicken Sie auf das erste Element, halten Sie dann die Umschalttaste gedrückt, und klicken Sie auf die anderen Elemente, die Sie zusammenfügen wollen.

    Hinweis: Die Elemente, die Sie zusammenfügen möchten, müssen (in der Dokumenthierarchie) nebeneinander liegen.

  2. Wählen Sie Element > Zusammenfügen.

    Alternativ können Sie mit der rechten Maustaste auf die Auswahl klicken und Zusammenfügen im Popupmenü wählen.

Die ausgewählten Elemente werden zu einem einzigen Element vom selben Typ zusammengefügt.

Teilen von Elementen

Sie können ein einzelnes Element in zwei Elemente teilen. Wenn beispielsweise eine Liste mehrere Listenelemente enthält, können Sie die Liste in zwei Listen teilen. Welche Listenelemente in den beiden neuen Listen enthalten sind, hängt davon ab, welches Element Sie zum Teilen der Liste ausgewählt haben. Außerdem können Sie einen Textabsatz, der in ein Element eingegliederten Text enthält, an dem eingegliederten Element teilen.

  1. Wählen Sie das Element, an dem Sie das übergeordnete Element teilen möchten.

    Sie können beispielsweise das Listenelement an der Stelle auswählen, an der Sie eine Liste teilen möchten.

    Oder Sie können das eingegliederte Element an der Stelle auswählen, an der Sie einen Absatz teilen möchten.

  2. Wählen Sie Element > Teilen.

    Alternativ können Sie mit der rechten Maustaste auf die Auswahl klicken und Teilen im Popupmenü wählen.

Das übergeordnete Element wird am ausgewählten untergeordneten Element geteilt.

Hinweis: Den Inhalt einer Tabelle können Sie nicht teilen. Außerdem müssen Sie beim Teilen eines Elements darauf achten, dass die Struktur des Dokuments nicht beschädigt wird.

Ausgliedern von Elementtext

Wenn Sie Text innerhalb eines Elements (Eingliedern von Elementen) eingliedern können, können Sie im eingliedernden Element festlegen, ob der Text entfernt werden soll.

  1. Wählen Sie das Element, mit dem Text in einem Dokument eingegliedert wird.

  2. Wählen Sie Element > Ausgliedern.

    Alternativ können Sie mit der rechten Maustaste auf die Auswahl klicken und Ausgliedern im Popupmenü wählen.

Das eingliedernde Element wird aus dem Text entfernt.

Bannertext

Bannertext in einem Dokument liefert visuelle Hinweise zum Arbeiten mit dem betreffenden Element in einem Dokument. Im folgenden Dokument, das auf der strukturierten Anwendung für DITA-Topics basiert, wird beispielsweise Bannertext angezeigt:

Bannertext zeigt an, was Sie in den unterschiedlichen Elementen eingeben müssen
Bannertext, der als visueller Hinweis für die Arbeit mit dem Element in einem Dokument fungiert

Wenn Sie den Cursor auf dem Bannertext platzieren, wird der gesamte Text ausgewählt. Sie können mit der Eingabe beginnen und der Bannertext wird ersetzt.

Ein- und Ausblenden von Bannertext

Sie können wählen, ob Bannertext in einem Dokument ein- oder ausgeblendet werden soll. Standardmäßig ist der Bannertext eingeblendet.

Wählen Sie zum Anzeigen oder Ausblenden von Bannertext im Menü „Ansicht“ die Option „Elementbannertext“.

Entfernen von Bannertext beim Löschen

Wenn Sie den Bannertext in einem Element auswählen und die Entf-Taste drücken, wird der Bannertext entfernt. Wenn Sie jedoch den Bannertext nicht durch neuen Text ersetzen, wird der gelöschte Text wieder im Element angezeigt, sobald Sie zu einem neuen Element wechseln.

Sie können dieses Standardverhalten außer Kraft setzen und sicherstellen, dass der Bannertext nach dem Löschen nicht wieder angezeigt wird. In diesem Fall wird der Bannertext auch dann nicht wieder angezeigt, wenn Sie das Dokument schließen und erneut öffnen.

Um sicherzustellen, dass der Bannertext gelöscht bleibt, müssen Sie das Flag „RedisplayBannerTextForemptyElements“ in der Datei maker.ini auf „OFF“ setzen.

Einstellungen für Bannertext

Neben dem oben beschriebenen Flag „RedisplayBannerTextForemptyElements“ können Sie Bannertext auch mithilfe der folgenden Einstellungen in der Dateimaker.ini konfigurieren:

Eigenschaft

Beschreibung

BannerTextFontAngle

Winkel des Bannertextes

BannerTextFontVariation

Variationen der Schriftbreite
BannerTextTextColor Schriftfarbe des Bannertextes

BannerTextBKcolor

Hintergrundfarbe des Bannertextes

Elementgrenzen

Wenn Sie in der WYSIWYG-Ansicht an einem strukturierten Dokument arbeiten, können Sie die Elementgrenzen als visuelle Hinweise nutzen. Elementgrenzen markieren in der WYSIWYG-Ansicht den Anfang und das Ende eines Elements. Sie können diese Grenzen als visuelle Hinweise zum Platzieren der Einfügemarke nutzen oder den Text innerhalb der Grenzen auswählen. Wenn Sie ein anderes Element vor oder hinter einem Element im Dokument einfügen möchten, können Sie die Einfügemarke vor oder hinter der öffnenden oder schließenden Grenze des Elements platzieren. Das weitere Vorgehen entspricht der Beschreibung unter Einfügen von Elementen.

Um Elementgrenzen als eckige Klammern um den Inhalt zu platzieren, wählen Sie Ansicht > Elementgrenzen.

Dokument mit Elementgrenzen in der WYSIWYG-Ansicht
Dokument mit Elementgrenzen in der Ansicht WYSIWYG

Um die Tag-Namen des Elements in den Elementgrenzen anzuzeigen, wählen Sie Ansicht > Elementgrenzen (als Tags).

Dokument mit Elementgrenzen mit Tags in der WYSIWYG-Ansicht
Dokument mit Elementgrenzen mit Tags in der Ansicht WYSIWYG

Erstellen einer Ausgabe mit Bannertext und Elementgrenzen

Bannertext und Elementgrenzen sind zwar Bestandteil der WYSIWYG-Ansicht eines FrameMaker-Dokuments, gehören aber nicht zum Dokumentinhalt. Wenn Sie beispielsweise in einem XML-Dokument arbeiten, sind Bannertext und Elementgrenzen in der XML-Ansicht nicht verfügbar.

Speichern als PDF

Da Bannertext und Elementgrenzen Bestandteil der WYSIWYG-Ansicht sind, werden sie auch in die PDF-Ausgabe einbezogen, wenn Sie in FrameMaker die Funktion „Als PDF speichern“ wählen.

Multikanal-Publishing

Da Bannertext und Elementgrenzen nicht zum Dokumentinhalt gehören, werden sie bei keinem der Ausgabeformate für Multikanal-Publishing einbezogen.

Arbeiten mit Attributen

Erfahren Sie, wie Sie in FrameMaker im strukturierten Authoring mit verschiedenen Attributen arbeiten.

Die Elemente in einem Dokument definieren den Inhalt des Dokuments. Außerdem können Sie mithilfe von Elementattributen zusätzliche Informationen zum betreffenden Element (Metadaten) angeben. Ein Attribut ist ein Name-Wert-Paar, das einem bestimmten Element zugeordnet ist. Beispiel: Die Inhaltselemente in einer strukturierten Anwendung weisen das Attribut Zielgruppe. Dieses Attribut können Sie dazu verwenden, Single-Source-Inhalt zu erstellen. Sie können das Attribut von Elementen z. B. auf „admin“ und „enduser“ setzen. Anschließend kann Ihre Veröffentlichungslösung mithilfe dieser Attribute Dokumente veröffentlichen, die auf den Attributwerten der Elemente basieren. In diesem Fall wären dies ein Dokument für Administratoren und ein weiteres Dokument für Endbenutzer. Auf ähnliche Weise kann zwischen Druck- und Onlineausgabe unterschieden werden.

Hinweis: Welche Elemente im Elementkatalog enthalten sind, wird durch die strukturierte Anwendung definiert, auf der das aktuelle Dokument basiert. Ebenso werden auch Attribute für die einzelnen Elemente in der zugeordneten strukturierten Anwendung definiert.

Festlegen von Attributwerten für Elemente

Festlegen von Attributwerten für Elemente

  1. Wählen Sie in der Dokumenthierarchie ein Element aus.

  2. Öffnen Sie das Dialogfeld Attribute (Element > Attribute bearbeiten).

  3. Klicken Sie im Dialogfeld auf ein Attribut.

    Am unteren Rand des Dialogfelds werden Informationen zu dem Attribut angezeigt:

    Name

    Der Name des Attributs, wie er im Dialogfeld angezeigt wird.

    Eingabe

    Die Angabe, ob der Attributwert optional oder erforderlich ist, sowie der Typ des Werts.

    Zeichenfolge

    Geben Sie einen Wert für das Attribut ein.

    Binominalkoeffizient

    Wählen Sie einen Wert aus der verfügbaren Dropdownliste.

    Standardwert

    Zeigt den Standardwert an, falls vorhanden, oder gibt an, dass kein Standardwert erforderlich ist.

  4. Bei Attributen vom Typ „Zeichenfolge“ können Sie einen Textwert eingeben.

    Bei Attributen vom Typ „Auswahl“ müssen Sie einen Wert aus der entsprechenden Dropdownliste wählen.

Anzeigen von Elementattributen

Sie können die für ein Element festgelegten Attributwerte im Dialogfeld „Attribute“ (Element > Attribute bearbeiten) anzeigen.

Alternativ können Sie die für ein Element festgelegten Attributwerte in der Strukturansicht anzeigen. So zeigen Sie die Attributwerte an:

  1. Klicken Sie in der Strukturansicht auf das Pfeilsymbol rechts neben dem Element.

    Wenn für das Element ein oder mehrere Attributwerte festgelegt sind, enthält die Liste nur die betreffenden Attribute. Das Pfeilsymbol wird jedoch weiterhin angezeigt.

    Klicken Sie erneut auf das Pfeilsymbol, um die vollständige Attributliste anzuzeigen.

  2. Wenn für das Element keine Attributwerte festgelegt sind, wird die vollständige Attributliste angezeigt.

Einrichten von Attributanzeige-Optionen beim Einfügen von Elementen

Sie können festlegen, wie beim Einfügen eines Elements in die Dokumenthierarchie die Attribute in der Strukturansicht angezeigt werden. Öffnen Sie zum Einrichten der Anzeigeoptionen das Dialogfeld „Attributanzeige-Optionen“ (Anzeige > Attributanzeige-Optionen).

Benötigte und angegebene Attribute

Beim Einfügen des Elements in das Dokument werden die erforderlichen und angegebenen Attribute für das Element angezeigt.

Alle Attribute

Beim Einfügen des Elements in das Dokument werden alle Attribute für das Element angezeigt.

Keine Attribute

Beim Einfügen des Elements in das Dokument werden keine Attribute für das Element angezeigt.

Hinweis: Wenn Sie die Optionen im Dialogfeld „Attributanzeige-Optionen“ ändern, werden die Einstellungen auf das derzeit geöffnete Dokument angewendet. Wenn Sie beispielsweise die Option von „Keine Attribute“ in „Alle Attribute“ ändern, werden in der Strukturansicht alle Elemente in den Dokumenten erweitert und alle Attribute angezeigt.

Kopieren der Attributwerte von einem Element in ein anderes

Sie können alle für ein Element festgelegten Attributwerte in andere Elemente in einem Dokument kopieren.

  1. Klicken Sie in der Strukturansicht mit der rechten Maustaste auf das Element, von dem Sie die Attributwerte kopieren möchten, und wählen Sie im Popupmenü Attributwerte kopieren.

  2. Klicken Sie mit der rechten Maustaste auf das Element, in das Sie die Attributwerte kopieren möchten, und wählen Sie im Popupmenü die Option „Einfügen“.

    Verwenden Sie zum Kopieren der Attributwerte auf mehrere Element die Option Umschalttaste+Eingabetaste, um mehrere nebeneinander liegende Elemente im Dokument auszuwählen, und wählen Sie Bearbeiten > Einfügen.

Erstellen von Gleichungen mithilfe des Pods „Gleichungen“

Erfahren Sie, wie Sie in FrameMaker Gleichungen mithilfe des Pods „Gleichungen“ erstellen können.

Eine Gleichung wird erstellt, indem Sie ein Gleichungselement einfügen und anschließend einen mathematischen Ausdruck für die Gleichung eingeben. Zum Einfügen eines Elements können Sie den Katalog Elemente verwenden. Sie können auch den Befehl „Neue Gleichung“ im Popupmenü „Gleichungen“ des Pods „Gleichungen“ verwenden.

Hinweis: Der Begriff „FrameMath-Element“ bezieht sich auf Teile eines Ausdrucks, wie z. B. einen Operator. Ein FrameMath-Element ist kein strukturelles Element.

Sie können alle Gleichungselemente sowohl für eingegliederte, als auch für freigestellte Gleichungen verwenden. In einigen Dokumenten ist möglicherweise ein Absatzelement definiert, das Formateigenschaften für freigestellte Gleichungen bereitstellt.

Die Formatregeln für Gleichungselemente schlagen für die Gleichung eine Gruppe von Schriftgrößen vor: „Klein“, „Normal“ oder „Groß“. Sie können zu anderen Schriftgrößen wechseln. Bei dieser Änderung handelt es sich nicht um eine irreguläre Formatzuweisung. Wenn Sie irreguläre Formatzuweisungen aus dem Dokument entfernen, wird die Gleichung nicht auf ihre ursprüngliche Schriftgröße zurückgesetzt.

Erstellen von Gleichungen in Absatztext mithilfe von Elementen

  1. Klicken Sie an der Stelle in den Text, an der Sie die Gleichung einfügen möchten. Wenn sich der Text in einem gedrehten Textrahmen befindet, machen Sie zunächst die Drehung rückgängig und drücken Sie Esc g Umschalt+d 0 (null).

  2. Wählen Sie ein Gleichungselement im Katalog Elemente aus, und klicken Sie auf Einfügen.

    Das Fragezeichen des neuen Gleichungsobjekts wird durch das erste von Ihnen eingegebene FrameMath-Element ersetzt.

    Neues Gleichungsobjekt
    Erstellen von Gleichungen in Absatztext mithilfe von Elementen

  3. Geben Sie die Gleichung entweder in Form von Zahlen und anderen Elementen manuell ein oder klicken Sie auf den Pod „Gleichungen“.

  4. Aktivieren Sie die Option „Gleichung einpassen“ im Kontextmenü „Gleichungen“ des Pods „Gleichungen“.

    In Absatztext eingepasste Gleichungen
    Rahmen um eine Gleichung im Absatztext anpassen

  5. Wenn die Gleichung auf beiden Seiten zu dicht am Text erscheint, fügen Sie vor bzw. nach dem Rahmen ein Leerzeichen ein. FrameMaker behandelt einen Rahmen, der eine Gleichung im Absatztext enthält, als ein Zeichen und erzeugt kein zusätzliches Leerzeichen um ihn herum.

    Wenn eine in einen Absatz eingefügte Gleichung zu groß für die Zeile ist, können Sie den festen Zeilenabstand für diesen Absatz deaktivieren.

Erstellen von freigestellten Gleichungen mithilfe von Elementen

  1. Wenn für Ihr Dokument ein Absatzelement zur Formatierung freigestellter Gleichungen definiert wurde, klicken Sie an der Stelle, an welcher der Absatz mit der Gleichung erscheinen soll. Wählen Sie das Absatzelement im Katalog Elemente aus, und klicken Sie auf Einfügen.

    Dieses Element kann Leerraum über und unter der Gleichung, die Ausrichtung in der Textspalte und eine automatisch nummerierte Beschriftung definieren.

  2. Klicken Sie in einem leeren Absatzelement an der Stelle, an der Sie die Gleichung einfügen möchten.

  3. Wählen Sie ein Gleichungselement im Katalog Elemente aus, und klicken Sie auf Einfügen.

    Neues Gleichungsobjekt
    Einfügen eines neuen Gleichungsobjekts

  4. Geben Sie die Gleichung ein.

  5. Aktivieren Sie „Gleichung einpassen“ im Popupmenü „Gleichungen“ der Palette.

    In Absatztext eingepasste freigestellte Gleichungen
    Einpassen freigestellter Gleichungen in Absatztext

  6. Wenn an der gewünschten Position kein Gleichungselement verfügbar ist, verwenden Sie evtl. ein ungültiges Element. Führen Sie eine der folgenden Aktionen aus:

    • Um ein Element zu verwenden, das in einem anderen Teil des Dokuments gültig ist, fügen Sie das Element an einer gültigen Position ein und verschieben es. Sie können auch die Einstellung Alle Elemente verwenden, um das Element überall verfügbar zu machen, und anschließend das Element an der gewünschten Position einfügen.

    • Um ein ungültiges Gleichungselement mit dem Standard-Tag GLEICHUNG einzufügen, wählen Sie „Neue Gleichung“ aus dem Kontextmenü „Gleichungen“ des Pods „Gleichungen“. Dem Element wird das Standard-Tag zugewiesen, wenn keine definierten importierten Grafikelemente verfügbar sind.

    Informieren Sie sich nach Einfügen des Elements bei Ihrem Entwickler darüber, wie sich das Element an dieser Position in ein gültiges Element umwandeln lässt.

Erstellen von Gleichungen in einem verankerten Rahmenelement

So erstellen Sie eine Gleichung in einem verankerten Rahmenelement:

  1. Wählen Sie einen verankerten Rahmen oder ein grafisches Objekt im Rahmen aus.

  2. Wählen Sie den Befehl „Neue Gleichung“ im Popupmenü „Gleichungen“ des Pods „Gleichungen“.

    Das Fragezeichen des neuen Gleichungsobjekts wird durch das erste von Ihnen eingegebene FrameMath-Element ersetzt. Die Gleichung wird nicht in der Dokumentstruktur angezeigt.

    Neue Gleichungsobjekte in einem Rahmen mit Grafikobjekten
    Neue Gleichungsobjekte in einem Rahmen mit Grafikobjekten

  3. Geben Sie die Gleichung ein.

Related information
Übersicht über den Pod „Gleichungen“
Anzeigebereich für verfügbare Elemente in einem strukturierten Dokument ändern
Gleichungen erstellen

Gleichungen mit MathML erstellen

Erfahren Sie, wie Sie in FrameMaker Gleichungen mit dem MathML-Stil-Editor und dem Struktur-Editor erstellen können.

Neben dem FrameMaker-Pod „Gleichung“ zum Hinzufügen von Gleichungen können Sie auch den Mathflow-Editor von Design Science verwenden, um komplexe mathematische Gleichungen zu gestalten. Sie können diese Gleichungen anschließend in Ihre FrameMaker-Dokumente einfügen. Sie können diese Gleichungen außerdem später im MathFlow-Editor bearbeiten und Dokumente, die MathML-Gleichungen enthalten, veröffentlichen.

MathML-Gleichungen können in strukturierten und unstrukturierten FrameMaker-Dokumenten verwendet werden.

Hinweis: Sie können außerdem MathML-Gleichungen in DITA 1.3-Themen (Thema, Aufgabe, Konzept, Referenz und Fehlerbehebung) einfügen. Beim Einfügen einer MathML-Gleichung wird ein neues Element mit dem Namen „mathml“ erstellt.

Wenn Sie PDF-Ausgabe für ein Dokument generieren, das MathML-Gleichungen enthält, kann ein Leser nach dem Inhalt dieser Gleichungen suchen.

FrameMaker enthält eine Testversion der folgenden MathFlow-Editoren:

Einen Vergleich der Leistungsmerkmale der Editoren finden Sie unter MathFlow-Editoren. Das Verfahren zum Upgrade auf die Vollversion des MathFlow-Editors finden Sie unter Konfigurieren der Installationseinstellungen.

Ein Video dazu finden Sie unter MathML in unstrukturierten Dokumenten.

MathML-Gleichung erstellen und in ein Dokument einfügen

  1. Wählen Sie im Menü „Einfügen“ die Option „MathML-Gleichung“.

  2. Erstellen Sie eine Gleichung im Fenster „MathFlow-Editor“.

    Weitere Informationen zum Erstellen von Gleichungen in MathFlow finden Sie in der MathFlow-Hilfe. Sie können die MathFlow-Hilfe im Fenster „MathFlow-Editor“ starten.

  3. Um die Gleichung zum Dokument hinzuzufügen, klicken Sie auf OK.

Die Gleichung wird in das Dokument eingefügt.

Hinweis: Wenn Sie die Fehlermeldung „Schriftartinitialisierung fehlgeschlagen“ erhalten, finden Sie eine Lösung im KB-Artikel Fehler bei MathML-Schriftartinitialisierung.

Wenn die MathML-Gleichung erstellt wurde, wird eine Bilddatei (.png) in das Dokument eingefügt.

Hinweis: FrameMaker unterstützt kein .eps-Dateiformat für MathML-Bilder.

MathML-Gleichung in einem Dokument bearbeiten

  1. Doppelklicken Sie die Gleichung im Dokument, oder klicken Sie mit der rechten Maustaste auf die Gleichung, und wählen Sie Mit MathFlow bearbeiten.

  2. Bearbeiten Sie die Gleichung im Fenster „MathFlow-Editor“.

  3. Um die Gleichung im Dokument zu aktualisieren, klicken Sie auf OK.

FrameMaker unterstützt außerdem die Optionen zum Kopieren/Einfügen und Rückgängigmachen/Wiederholen für MathML-Gleichungen in einem Dokument.

Wichtig: Sie können MathML-Gleichungen in strukturierten (DITA 1.3) und unstrukturierten Dokumenten an jeder geeigneten Stelle des Dokuments einfügen. Bei Ihren eigenen strukturierten Dokumenten müssen Sie jedoch zunächst ein Element im Elementkatalog definieren, das diese Art von Objekt unterstützt. FrameMaker enthält eine strukturierte Beispiel-App (für DITA 1.2), die ein MathML-Element umfasst. Weitere Informationen zum Verwenden dieses Elements finden Sie unter Strukturierte DITA-MathML-Beispiel-App.

Konfigurieren der MathFlow-Einstellungen in FrameMaker

Öffnen Sie zum Konfigurieren von MathML-Einstellungen in FrameMaker das Dialogfeld Voreinstellungen, und wechseln Sie zur Registerkarte „MathML“.

Konfigurieren der Installationseinstellungen

FrameMaker enthält eine 30-tägige Testversion der MathFlow Stil- und Strukur-Editoren von Design Science. Sie können die Vollversion der Editoren von Design Science erhalten und sie in FrameMaker integrieren.

  1. Nach der Installation der Vollversion der Stil- und Strukur-Editoren rufen Sie den Abschnitt „MathFlow“ der Registerkarte „MathFlow“ auf.

  2. Die Testversion, die im Lieferumfang von FrameMaker enthalten ist, ist im Installationspfad von Adobe FrameMaker installiert. Falls MathFlow in einem anderen Pfad installiert ist, geben Sie diesen Pfad an.

  3. Geben Sie im Textfeld Pfad zur Lizenzdatei den Pfad zur Lizenzdatei an und klicken Sie auf OK.

Sie müssen FrameMaker neu starten, um sicherzustellen, dass diese Änderungen übernommen werden.

Hinweis: Die 30-tägige Testversion von MathFlow beginnt, wenn Sie den Editor zum ersten Mal aufrufen. Sie beginnt nicht bei Installation der FrameMaker-Version, in welcher der Editor integriert ist.

Formatieren einer MathML-Gleichung

Sie können die Formatierung einer ausgewählten MathML-Gleichung in einem Dokument aktualisieren oder die Voreinstellungen für alle MathML-Gleichungen ändern. Standardmäßig ist die Schriftgröße der Gleichungen auf 14 px gesetzt. Der DPI-Wert für die Bilder, die FrameMaker für jede Gleichung in ein Dokument einfügt, beträgt standardmäßig 300 DPI. Sie können eine Gleichung auch eingebunden mit dem eingeschlossenen Absatz platzieren und die Formatierung des eingeschlossenen Absatzes für die Gleichung übernehmen.

So aktualisieren Sie die Formatierung der momentan ausgewählten MathML-Gleichung:

  1. Wählen Sie die MathML-Gleichung aus und wählen Sie Grafik > Objekteigenschaften.

    Oder wählen Sie Grafik > Objektstilgestaltung.

    Diese Optionen sind auch im Kontextmenü verfügbar.

  2. Aktualisieren Sie die Formatierung für die momentan ausgewählte MathML-Gleichung im Dialogfeld „Eigenschaften der MathML-Gleichung“.

    Dialogfeld „Eigenschaften der MathML-Gleichung“
    Formatieren einer MathML-Gleichung im Dialogfeld „Eigenschaften der MathML-Gleichung“

    DPI und Schrift
    Ändern Sie die Einstellungen für den DPI-Wert und die Schriftgröße.
    Eingebunden
    Platzieren Sie das Bild eingebunden mit dem eingeschlossenen Absatz.
    Absatzstil anwenden

    Wenden Sie die folgenden Formate des eingeschlossenen Absatzes auf die Gleichung an:

    • Schrift

    • Schriftfamilie

    • Hintergrundfarbe

    • Vordergrundfarbe

Sie können diese Einstellungen auch global auf alle MathML-Gleichungen anwenden, die anschließend erstellt werden.

  1. Öffnen Sie das Dialogfeld „Voreinstellungen“ (Bearbeiten > Voreinstellungen).

  2. Ändern Sie auf der Registerkarte „MathML“ im Abschnitt „Einstellungen für MathFlow“ die Einstellungen für die Gleichung.

Diese Einstellungen werden sofort wirksam. Sie müssen FrameMaker dafür nicht neu starten.

Konfigurieren des MathFlow-Editors

Die Testversion des MathFlow-Editors umfasst die Stil- und Struktur-Editoren. Während dieses Testzeitraums können Sie zwischen diesen Editoren wählen.

  1. Um den MathFlow-Editor zu ändern, wechseln Sie auf der Registerkarte „MathML“ zum Abschnitt Editortyp.

  2. Wählen Sie den entsprechenden MathFlow-Editor aus und klicken Sie auf OK.

Sie müssen FrameMaker neu starten, um sicherzustellen, dass diese Änderungen übernommen werden.

Hinweis: Wählen Sie bei der Installation der Vollversion von MathFlow zwischen dem Stil- und Struktur-Editoren. Die Integration der Testversion von MathFlow mit FrameMaker umfasst beide Editoren. Es wird Ihnen daher empfohlen, beide Editoren zu verwenden, wenn Sie diese Funktion testen.

Strukturierte DITA-MathML-Beispiel-App

In FrameMaker ist die MathML-Beispielanwendung DITA_1.2_MathML_Sample für DITA 1.2 enthalten. Dieses <mathml>-Element bietet vollständige Unterstützung für die MathML-Gleichungen, die von den MathFlow-Stil- und -Struktur-Editoren wiedergegeben werden. Sie können zum Einfügen von MathML in ein Dokument eine Datei basierend auf dieser Anwendung erstellen und anschließend das darin enthaltene MathML-Element verwenden.

Ein Video dazu finden Sie unter MathML in strukturierten Dokumenten.

MathML-Element einfügen

  1. Wählen Sie Datei > Neu > XML.

  2. Wechseln Sie im Dialogfeld Neue XML-Datei zur Registerkarte Strukturierte Anwendungen, wählen Sie DITA_1.2_MathML_Sample, und klicken Sie auf OK.

    Ein neues Dokument wird erstellt.

  3. Wählen Sie eine Stelle des Dokuments aus, an der Sie eine MathML-Gleichung einfügen möchten.

    Das MathML-Element „mathml“ ist im Elementkatalog der strukturierten Beispiel-App verfügbar.

    Hinweis: Ein MathML-Element ist an jeder beliebigen Stelle im Dokument verfügbar, an der ein fremdes Element zur Verfügung steht.

  4. Doppelklicken Sie das Element <mathml>, um es an der Stelle im Dokument einzufügen.

  5. Rufen Sie die XML-Ansicht des aktuellen Dokuments auf.

    Die XML-Ansicht des strukturierten Dokuments enthält einen MathML-Knoten an der Stelle, an der Sie das MathML-Element eingefügt haben.

    Hinweis: Jedes Element innerhalb des MathML-Knotens ist mit einem MML-Präfix versehen. Dieses Präfix soll Namenskonflikte mit anderen Elementen, die in der XML-Datei verwendet werden, verhindern. Diese Elemente stammen entweder aus dem Elementkatalog der strukturierten App oder von in der MathML-Struktur definierten Elementen.

Sie können außerdem die Gleichung im MathML-Knoten in der XML-Ansicht bearbeiten. Die Änderungen werden anschließend in der WSIYWIG-Ansicht angezeigt.

Hinweis: Wenn Sie ein DITA_1.2_MathML_Sample-Dokument veröffentlichen möchten, ohne eine MathML-Gleichung einzufügen, wird keine Ausgabe für dieses Dokument generiert.

Ändern der Textrichtung

Erfahren Sie, wie Sie in FrameMaker die Textrichtung in strukturierten Dokumenten ändern können.

Die Richtung (LTR oder RTL) eines strukturierten Dokuments ist in der zugeordneten strukturierten Anwendung definiert. Wenn die strukturierte Anwendung die Dokumentenrichtung unterstützt, können Sie die Richtung des Textes in unterstützten Elementen im Dokument ändern.

So ändern Sie die Richtung des Textes eines Elements:

  1. Wählen Sie das Element in der Strukturansicht.

  2. Öffnen Sie den Attributeditor und ändern Sie das Attribut dir.

FrameMaker bietet Out-of-the-Box-Richtungsunterstützung für DITA-Themen (Thema, Aufgabe, Konzept und Referenz). Sie können aber auch Ihre eigene strukturierte Anwendung mit Richtungsunterstützung erstellen.

FrameMaker enthält jetzt eine neue Richtungseigenschaft. Diese können Sie in Ihrer strukturierten Anwendung nutzen.

Sie können beispielsweise eine Lese-/Schreibregel (wie unten angegeben) erstellen, um anzugeben, dass die FrameMaker-Richtungseigenschaft dem strukturierten Dokument dir-Attribut zugewiesen wird:

attribute "dir"
{
   is fm attribute;
   is fm property direction;
}
Hinweis: Wenn Sie das Richtungsattribut eines Elements in einer Nicht-DITA-XML-Datei ändern, ändert sich die Richtung des Inhalts nicht sofort. Sie müssen die XML-Datei schließen und wieder öffnen, damit die Änderungen übernommen werden.

Weitere Informationen zum Hinzufügen von Richtungsunterstützung zu Ihren eigenen strukturierten Anwendungen finden Sie im FDK-Programmiererhandbuch.

Intelligente Einfügefunktion

Lernen Sie die intelligente Einfügefunktion kennen und erfahren Sie, wie diese in FrameMaker dabei hilft, Inhalte aus HTML, Word, Excel oder Outlook als DITA-Inhalt einzufügen.

Mit FrameMaker können Sie HTML-, Microsoft® Word-, Microsoft® Excel- und Microsoft® Outlook-Inhalte als DITA-Inhalt einfügen. Sie können außerdem XSLs für andere FrameMaker-strukturierte Anwendungen erstellen und konfigurieren. Bei der Verwendung von XSL identifiziert FrameMaker den Inhalt noch in der Zwischenablage und strukturiert diesen entsprechend der geeignetsten Elementhierarchie oder -folge. Anschließend können Sie ihn mithilfe der intelligenten Einfügefunktion in FrameMaker als DITA-Inhalt einfügen.

Hinweis: Beim Einfügen von Text einer bestimmten Richtung (links nach rechts oder rechts nach links) in ein FrameMaker-Dokument müssen Sie sicherstellen, dass die Textrichtung der Zielposition (Dokument, Tabelle oder Absatz) auf die selbe Richtung festgelegt ist.

Der eingefügte Inhalt ist entsprechend einer angegebenen XSL in der relevanten strukturierten Anwendung strukturiert. Die XSLs werden für folgende DITA-Dokumente in FrameMaker angegeben:

Der XSL-Dateiname und -pfad werden mithilfe des Stylesheet-Elements (Stylesheets > XSLTPreferences > SmartPaste > Stylesheet) angegeben.

Die XSLs für die intelligente Einfügefunktion für DITA befinden sich unter:

$STRUCTDIR\xml\DITA_1.2\app\technicalContent\xslt\
Die in der DITA_1.2_topic-Anwendung hinzugefügte XSL für die intelligente Einfügefunktion
Einfügen von HTML-, MS® Word-, MS® Excel- und MS® Outlook-Inhalten als DITA-Inhalte mithilfe der intelligentem Einfügefunktion

Inhalt über die intelligente Einfügefunktion in eine DITA-Datei einfügen

So fügen Sie Inhalte mit der intelligenten Einfügefunktion in eine DITA-Datei ein:

  1. Kopieren Sie HTML-, Microsoft® Word-, Microsoft® Excel- oder Microsoft® Outlook-Inhalt.

  2. Positionieren Sie den Cursor in eins der folgenden DITA-Themen: topic, task, concept oder reference.

  3. Wählen Sie im Kontextmenü die Option Intelligentes Einfügen. (Tastaturkurzbefehl für die intelligente Einfügefunktion: Esc+s+p+t)

    Der eingefügte Inhalt ist in entsprechende, von der Struktur zulässige Elemente strukturiert.

XSL-Datei für benutzerdefinierte XML-Anwendung über intelligente Einfügefunktion hinzufügen

Sie können außerdem eine XSL für das intelligente Einfügen von Inhalten für Ihre benutzerdefinierte strukturierte Anwendung erstellen.

  1. Erstellen Sie eine entsprechende XSL-Datei für Ihr EDD.

  2. Öffnen Sie die Datei structapps.fm.

  3. Fügen Sie unter <Stylesheets>\<XSLTPreferences> das Element<SmartPaste> hinzu und die folgenden darunterliegenden Elemente:

    1. <>Stylesheet: Pfad für die entsprechende XSL-Datei.

    2. <StylesheetParameters>: Dieses Element besitzt zwei untergeordnete Elemente: <ParameterName> und <ParameterExpression>. Details finden Sie in einer DITA-Anwendung in structapps.fm.

  4. Speichern Sie die Datei.

  5. Wählen Sie Struktur > Anwendungsdefinition > Anwendungsdefinitionen lesen.

    Jetzt können Sie die intelligente Einfügefunktion für eine XML-Datei, basierend auf der benutzerdefinierten Anwendung, verwenden.

Bedingter Text in XML

Erfahren Sie, was bedingter Text in XML in FrameMaker ist.

Das strukturierte FrameMaker-Format ermöglicht Ihnen das Exportieren und Importieren allen bedingten Textes (sichtbar und verborgen) mit allen Informationen über Bedingungs-Tags, wie z. B. ihr Status bezüglich der Ein-/Ausblendung, der Farbe und des Stils.

Damit bedingter Text beim Speichern und Öffnen von XML-Dateien erhalten bleibt, enthält die von FrameMaker erzeugte XML-Datei Folgendes:

Zusätzlich zur Unterstützung für normalen Text wird auch bedingter Text in XML unterstützt. Dies führt dazu, dass ganze Tabellen oder Tabellenzeilen bedingt sein können. Dasselbe gilt für Fußnoten, Marken und verankerte Grafiken. Bedingter Text kann sich auch innerhalb eines Texteinschubs (XML oder Text) befinden.

Unterstützung für OLE-Objekte

Erfahren Sie, was die OLE-Objektunterstützung in FrameMaker ist.

Die strukturierte FrameMaker-Version unterstützt jetzt das Roundtripping von OLE-Objekten, z. B. Visio-Objekten und PowerPoint-Präsentationen. FrameMaker verwendet eine XML-Verarbeitungsanweisung für die Verarbeitung von OLE-Objekt-Roundtripping.

Sie können die OLE-Unterstützung mithilfe des Flags DirectOLESupportInXml in der Datei „maker.ini“ steuern. Um diese Funktion zu aktivieren, legen Sie das Flag als On fest. Der Standardwert des Flags ist „Off“. Ist dieses Flag „Off“, wird das OLE-Objekt als .mif-Datei.

Beachten Sie außerdem folgende Einträge in der Datei maker.ini:
54="pptx"  OLE2 OLE2  OLE2     FMGFXImport "pptx" frame.exe ^.pptx 
55="VSD"  OLE2 OLE2  OLE2      FMGFXImport "VSD" frame.exe ^.vsd
Diese Einträge weisen einer Datei beim Import einen automatischen Filter filetype zu. Sie können bei Bedarf weitere Filter (mit entsprechenden OLEs) hinzufügen.

So fügen Sie ein OLE-Objekt ein:

  1. Wählen Sie Datei > Importieren > Objekt. Das Dialogfeld Objekt einfügen wird angezeigt.

  2. Navigieren Sie zum OLE-Objekt und wählen Sie Aus Datei erstellen oder Verknüpfung aus:

  3. Klicken Sie auf „OK“.

Hinweis: Sie können ein OLE-Objekt ebenfalls einfügen, indem Sie den Befehl „Einfügen Spezial“ verwenden und „Verknüpfen“ wählen.

Umgang mit Leerraumzeichen

Erfahren Sie, wie Leerräume in FrameMaker verarbeitet werden, und lernen Sie den Standard für die Leerraumnormalisierung kennen.

Wenn Sie eine XML-Datei in der WYSIWYG- oder Autor-Ansicht von FrameMaker öffnen, wird der Leerraum normalisiert.

Leerräume in XML sind folgende Zeichen: Leerzeichen, Tabulatorzeichen und Leerzeile/Neue Zeile (außer bei erzwungenem Zeilenumbruch). Leerräume dienen folgenden Zwecken:

  1. Sie formatieren das Dokument in seiner Quellform, wie z. B. für Code, um dem XML-Dokument eine semantische Bedeutung zu verleihen.

  2. Bei Verwendung eines Texteditors zur Bearbeitung eines XML-Dokuments fügen Sie Leerzeichen und Zeilenumbrüche in das Inhaltsmodell des Elements ein, um für bessere Lesbarkeit des XML-Inhalts zu sorgen. Dieser Leerraum ist nicht Teil der Informationen des Dokuments und hat keine semantische Bedeutung für die XML-Anwendung.

    Hinweis: Standard-Prettyprinting ist in der XML-Ansicht für neue und bearbeitete Dokumente deaktiviert.

W3C hat definiert, wie Leerräume in XML-Dokumenten in Leerräume in XML-Anwendungen umgesetzt werden.

Standard für die Leerraumnormalisierung

FrameMaker verwendet entsprechend dem Standard folgende Regeln für die Leerraumnormalisierung:

  1. XML ignoriert die erste Folge von Leerräumen direkt nach dem öffnenden Tag und die letzte Folge von Leerräumen vor dem schließenden Tag.

  2. XML übersetzt Zeichen, die keine Leerzeichen sind (Tabulatorzeichen und Neue Zeile), in Leerzeichen und fasst alle Leerzeichen zu einem Leerzeichen zusammen.

  3. XML ignoriert die Folge von Leerräumen zwischen zwei Elementen, falls das übergeordnete Element über Elementinhalt verfügt.

  4. Sie können das Attribut xml:space eines Elements so festlegen, dass die Leerräume beibehalten werden. Beispiel: Wenn Folgendes normalisiert wird (wie in der XML-Code-Ansicht angezeigt):

    Hickory[SPACE][SPACE][SPACE]dikory dock. 
The mouse[TAB][SPACE]ran up the clock.

    Es wird folgendermaßen angezeigt (in der WYSIWYG-Ansicht):

    Hickory[SPACE]dikory dock. 
The mouse[SPACE]ran up the clock.

  5. Leerräume, die durch Erweiterung von Zeichenreferenzen (z. B. Leerzeichen =&#32; Tabulator= &#9; Neue Zeile=&#10;) hinzugefügt werden, werden beim Öffnen des XML-Dokuments beibehalten. Sie werden gemäß den Regeln oben nicht als Leerräume betrachtet.

    Beispiel: FrameMaker normalisiert Folgendes (wie in der XML-Code-Ansicht angezeigt):

    Hickory&#32;&#32;&#32;dikory dock. 
The mouse&#9;&#32;ran up the clock.

    Nach der Normalisierung wird tt folgendermaßen angezeigt (in der WYSIWYG-Ansicht):

    Hickory[SPACE][SPACE][SPACE]dikory dock. 
The mouse[TAB][SPACE]ran up the clock.

Deaktivieren der Entfernung von Leerräumen beim Import

Um das Entfernen von Leerräumen zu deaktivieren, setzen Sie die Eigenschaft RemoveExtraWhiteSpacesOnXMLImport in maker.ini auf FALSE.

Hinweis: Gehen Sie beim Bearbeiten von INI-Dateien sehr sorgfältig vor.

Beibehalten von Leerräumen für bestimmte Elemente

Wenn das Attribut xml:space auf preserve (xml:space=”preserve”) festgelegt ist, behält FrameMaker alle Leerräume bei. Verwenden Sie diese Einstellung, um Leerräume nur für bestimmte Elemente beizubehalten. Diese Einstellung lässt zu, dass FrameMaker die Leerräume für alle anderen Elemente in den WYSIWYG- und Autor-Ansichten entfernt.

Querverweise in XML

Erfahren Sie mehr über Querverweise in XML in FrameMaker.

Im strukturierten FrameMaker-Format können Sie beim Speichern und Öffnen von XML-Dateien externe Querverweise erzeugen und beibehalten.

Wenn beispielsweise Ihre FrameMaker-Datei einen Querverweis zu einer anderen Datei enthält, erzeugt FrameMaker beim Speichern der Datei in XML Tags, welche die Querverweise mit den Informationen über die Referenzdateien repräsentieren. Beim Öffnen derselben XML-Datei konvertiert FrameMaker die Tags für die Querverweise und die darin enthaltenen Informationen in FrameMaker-Querverweise.

FrameMaker unterstützt das Attribut srcfile, mit dessen Hilfe Informationen von externen Querverweisen beim Erzeugen von XML-Dokumenten erhalten bleiben.

Beim Exportieren einer Datei mit einem externen Querverweis zu XML enthält das Attribut srcfile des Querverweises den Namen der Referenzdatei und die ID für das referenzierte Element in der Datei.

Hinweis: FrameMaker konvertiert Dateipfade im erzeugten XML-Format in URIs.

Roundtripping von Tabelleneigenschaften

Verstehen Sie das Roundtripping von Tabelleneigenschaften in Adobe FrameMaker.

Lese-/Schreibregeln verwenden die Roundtrip-Funktion der Eigenschaften für Tabellenformatierung. Neue Lese-/Schreibregelzuordnung für die Tabellenzelleneigenschaften lautet wie folgt:

Eigenschaft

Lese-/Schreibregel (nicht CALS)

Lese-/Schreibregel (CALS)

Attributwert

FP_CellAngle

Zellenwinkel

rotate

Integer

FP_CellOverrideFill

Irreguläre Füllung

k. A.

Integer corresponding to FDK values

FP_CellUseOverrideFill

Irreguläre Füllung verwenden

k. A.

0 = False

Nicht-Null-Wert = True

FP_CellOverrideShading

Irreguläre Schattierung

k. A.

Tag: FO_Color

FP_CellUseOverrideShading

Irreguläre Schattierung

k. A.

0 = False

Nicht-Null-Wert = True

FP_CellOverrideBottomRuling

Irreguläre Lineatur unten

k. A.

Tag: FO_RulingFmt

FP_CellUseOverrideBRuling

Irreguläre Lineatur unten

k. A.

0 = False

Nicht-Null-Wert = True

FP_CellOverrideLeftRuling

left ruling override

k. A.

Tag: FO_RulingFmt

FP_CellUseOverrideLRuling

left ruling override

k. A.

0 = False

Nicht-Null-Wert = True

FP_CellOverrideRightRuling

right ruling override

k. A.

Tag: FO_RulingFmt

FP_CellUseOverrideRRuling

right ruling override

k. A.

0 = False

Nicht-Null-Wert = True

FP_CellOverrideTopRuling

top ruling override

k. A.

Tag: FO_RulingFmt

FP_CellUseOverrideTRuling

top ruling override

k. A.

0 = False

Nicht-Null-Wert = True

Die Lese-/Schreibregelzuordnung für die Tabellenzelleneigenschaften lautet wie folgt:

Eigenschaft

Lese-/Schreibregel (nicht CALS)

Lese-/Schreibregel (CALS)

Attributwert

FP_RowKeepWithNext

keep with next

k. A.

0 = False

Nicht-Null-Wert = True

FP_RowKeepWithPrev

keep with next

k. A.

0 = False

Nicht-Null-Wert = True

FP_RowStart

row placement

k. A.

Integer corresponding to FDK values

Im folgenden Beispiel steuert das prop5-Attribut die Abschlusslineatur der Tabelle.

element "tablecell" 
{ 
is fm table cell element; 
attribute "prop1" is fm property right ruling override; 
attribute "prop2" is fm property use right ruling override; 
attribute "prop3" is fm property top ruling override; 
attribute "prop4" is fm property use top ruling override; 
attribute "prop5" is fm property bottom ruling override;  
attribute "prop6" is fm property use bottom ruling override; 
attribute "prop7" is fm property left ruling override; 
attribute "prop8" is fm property use left ruling override; 
attribute "prop9" is fm property cell angle; 
}

Im folgenden Beispiel steuern die att1, att2, att3 und att4-Attribute die Schattierungseigenschaften der Tabellenzelle:

element "tablecell2" 
{ 
is fm table cell element; 
attribute "att1" is fm property shading override; 
attribute "att2" is fm property use shading override; 
attribute "att3" is fm property bottom ruling override; 
attribute "att4" is fm property use bottom ruling override;  
attribute "att5" is fm property fill override; 
attribute "att6" is fm property use fill override; 
}

Roundtripping von Gleichungen und verankerten Rahmen

Erfahren Sie mehr über Roundtripping von Gleichungen und verankerte Rahmen in FrameMaker.

Sie können Roundtripping von Gleichungen und verankerten Rahmen zwischen strukturierten FrameMaker-Versionen und XML-Dateien durchführen. Beim Speichern eines strukturierten FrameMaker-Dokuments in einer XML-Datei erstellt FrameMaker MIF-Dateien für die Gleichungen und verankerten Rahmen in dem Dokument. FrameMaker speichert alle verankerten Rahmen und Gleichungen in einer anderen MIF-Datei.

Hinweis: Sie können diese Funktion mithilfe der XML-Anwendung „ReportPlain“ in der Datei samplesStructapps.fm unter <Fm_Installationspfad>\Structure testen. Diese XML-Anwendung verfügt über Gleichungs- und Rahmenelemente.

Sie können den Typ der Dateien ändern, die zum Speichern von Gleichungen und verankerten Rahmen erstellt werden, indem Sie folgendes Flag in der Datei „maker.ini“ festlegen.

Um das Standardvektorformat für XML festzulegen, bearbeiten Sie die Datei „maker.ini“ (Benutzerbereich) und fügen Sie das Flag DefaultvectorformatforXMLexport flag hinzu. Folgendes Flag legt das Standardvektorformat für XML als CGM fest:

DefaultvectorformatforXMLexport=CGM

January 19, 2022

Legal Notices | Online Privacy Policy