Benutzerhandbuch Abbrechen

Arbeiten mit den gängigen Inhaltsstilen

  1. Benutzerhandbuch zu RoboHelp
  2. Einführung
    1. Erste Schritte im RoboHelp-Arbeitsbereich
    2. Neuerungen bei RoboHelp (2022 release)
      1. Neuerungen in Update 5
      2. Neuerungen in Update 4
      3. Neuerungen in Update 3
      4. Neuerungen in Update 2
      5. Neuerungen in Update 1
    3. Behobene Probleme in RoboHelp
    4. Systemanforderungen für RoboHelp
    5. Herunterladen von RoboHelp für Windows und macOS
    6. Herunterladen und Installieren der Adobe-App
    7. Häufig gestellte Fragen zu RoboHelp
    8. Neuerungen bei RoboHelp (2020 release)
      1. Neuerungen in Update 8
      2. Neuerungen in Update 7
      3. Neuerungen in Update 6
      4. Neuerungen in Update 5
      5. Neuerungen in Update 4
      6. Neuerungen in Update 3
      7. Neuerungen in Update 2
      8. Neuerungen in Update 1
  3. Projekte
    1. Planen Ihres RoboHelp-Projekts
    2. Erstellen eines Projekts
    3. Verwalten von Projekten
    4. Arbeiten mit Themen und Ordnern
    5. Generieren von Berichten
    6. Arbeiten mit kontextsensitiver Hilfe
    7. Verwalten von Verweisen
    8. Festlegen von Einstellungen in RoboHelp
  4. Zusammenarbeit mit Autoren
    1. Zusammenarbeit mithilfe von Git
    2. Zusammenarbeit mithilfe von SharePoint Online
    3. Zusammenarbeit mit von Azure DevOps (Team Foundation Server)
  5. PDF-Layout
    1. PDF-Vorlagen
    2. Designen eines Seitenlayouts
    3. PDF-Ausgabe veröffentlichen
    4. Arbeiten mit den gängigen Inhaltsstilen
    5. Komponenten einer PDF-Vorlage
    6. Unterstützung für Sprachvariablen
    7. Anpassen von PDFs
  6. Bearbeiten und Formatieren
    1. Formatieren Ihres Inhalts
    2. Erstellen und Verwalten von Querverweisen
    3. Erstellen und Verwalten von Verknüpfungen
    4. Snippets als Einzelquellenelemente
    5. Arbeiten mit Bildern und Multimedia
    6. Erstellen und Verwenden von Variablen für einfache Updates
    7. Arbeiten mit Variablensätzen
    8. Verwenden des Tools „Suchen und Ersetzen“
    9. Automatisches Speichern Ihrer Inhalte
    10. Bearbeitung nebeneinander in der geteilten Ansicht
    11. Verwenden der Rechtschreibprüfungsfunktion
    12. Erstellen und Bearbeiten von Lesezeichen
    13. Einfügen und Aktualisieren von Feldern
    14. Wechseln zwischen mehreren Ansichten
    15. Automatische Nummerierung in CSS
  7. Importieren und Verknüpfen
    1. Importieren von Markdown-Dateien in ein Projekt
    2. Importieren von Word-Dokumenten in ein Projekt
    3. Importieren von FrameMaker-Dokumenten in ein Projekt
  8. Inhaltsverzeichnisse, Indizes, Glossare und Zitate
    1. Erstellen und Verwalten von Inhaltsverzeichnissen
    2. Erstellen und Verwalten von Indizes
    3. Erstellen und Verwalten eines Glossars
    4. Erstellen und Verwalten von Zitaten
    5. Abfolgen erstellen und verwalten
    6. Arbeiten mit „Siehe auch“ und verwandten Themen
  9. Bedingter Inhalt
    1. Was ist bedingter Inhalt?
    2. Bedingungs-Tags erstellen und anwenden
    3. Konfigurieren von Ausgabevorgaben für bedingten Inhalt
    4. Bedingten Inhalt optimieren und verwalten
  10. Microcontent
    1. Microcontent
  11. Überprüfung und Zusammenarbeit
    1. Überprüfung und Zusammenarbeit
  12. Übersetzung
    1. Übersetzen von Inhalten in mehrere Sprachen
    2. Konfigurieren eines Übersetzungsframeworks für einen Dienstleister
  13. Generieren der Ausgabe
    1. Generieren der Ausgabe
    2. Generieren einer Frame-los-Ausgabe
    3. Generieren der Wissensdatenbankausgabe
    4. Generieren von PDF-Ausgabe
    5. Generieren einer interaktiven HTML5-Ausgabe
    6. Generieren einer Worddokument-Ausgabe
    7. Generieren einer „Nur Inhalt“-Ausgabe
    8. Generieren einer E-Book-Ausgabe
    9. Generieren einer Microsoft HTML Help-Ausgabe in RoboHelp
    10. Generieren einer App-Ausgabe
  14. Ausgabe veröffentlichen
    1. Veröffentlichen auf einem RoboHelp-Server
    2. Veröffentlichen auf einem FTP-Server, einem sicheren FTP-Server oder einem Dateisystem
    3. Veröffentlichen in SharePoint Online
    4. Veröffentlichen im Zendesk-Hilfe-Center
    5. Veröffentlichen in der Salesforce-Wissensdatenbank
    6. Veröffentlichen in der ServiceNow-Wissensdatenbank
    7. Veröffentlichen in der Zoho-Wissensdatenbank
    8. Veröffentlichen in Adobe Experience Manager
    9. Veröffentlichen in der Atlassian Confluence-Wissensdatenbank
  15. Anhang
    1. Adobe RoboHelp Scripting-Referenz
    2. RoboHelp-Tastaturbefehle

Arbeiten mit den gängigen Inhaltsstilen

Ein Stylesheet enthält die Definitionen von Formaten für die Elemente, die in der PDF-Ausgabe verwendet werden. Sie können wählen, ob Sie mit den Beispiel-Stylesheets arbeiten oder neue erstellen möchten. In den meisten Fällen hilft Ihnen das Erstellen einer Kopie des OOTB-Beispiel-Stylesheets bei einem schnellen Einstieg.

Der Formatvorlagen-Editor ist ein WYSIWYG-Editor, der die gesamte Komplexität eines CSS-Codes hinter der Benutzeroberfläche verbirgt. Mit dem Formatvorlagen-Editor können Sie die Formate einfach und sehr schnell für die Elemente Ihrer Wahl anpassen. Die Formatvorlagen sind unter den folgenden Überschriften kategorisiert:

  • Überschriftenformate
  • Absatzstile
  • Zeichenstile
  • Hyperlink-Stile
  • Bildformate
  • Listenformatvorlagen
  • Tabellenstile
  • Div. Stile
  • Seitenformate
  • Andere Stile

Wenn Sie mit einem Projekt arbeiten, ist die Formatvorlagenzuordnung für die meisten DITA-Elemente im Standard-Stylesheet vorhanden. Wenn Sie mit Standard-DITA-Elementen arbeiten, können Sie deren Aussehen ändern, indem Sie direkt Änderungen an der Formatvorlagendefinition vornehmen. Diese Formatvorlagendefinitionen sind in der Kategorie "Andere Formatvorlage" verfügbar.

In den folgenden Abschnitten werden die am häufigsten verwendeten Formatvorlageneinstellungen in Form von Beispielen behandelt.

Arbeiten mit Überschriften-Formatvorlagen

Die Überschriften-Formatvorlagen kapseln alle Basisformatvorlagen für die Überschriften, die in Ihren Inhalten verwendet werden. Standardmäßig erhalten Sie 6 grundlegende Überschriften-Formatvorlagen und eine Überschriften-Formatvorlage für die Überschrift des Themas/Kapitels und des Anhangs. In einem strukturierten Dokument stellt H1 den Titel des Themas oder Kapitels dar und H2 bis H6 werden für Unterthemen oder Abschnitte innerhalb eines Themas/Kapitels verwendet. Diese Hierarchie von Überschriften wird automatisch auf Ihre Inhalte angewendet, wenn die entsprechende Überschrift gefunden wird.

Erstellen benutzerdefinierter Überschriften auf Kapitelebene

In einem Projektinhaltsverzeichnis arbeiten Sie mit Kapiteln. Die Basisformatvorlagen für Überschriften sind so konzipiert, dass sie ohne Anpassungen auf Ihre Kapitelüberschriften angewendet werden können. Wenn Sie jedoch spezielle Überschriften für Ihre Inhalte erstellen möchten, müssen Sie diese Überschriften erstellen. Beispielsweise wird die standardmäßige h1.chapter-Überschrift auf den Titel Ihres Kapitels angewendet. Wenn der Kapiteltitel in einer anderen Formatvorlage angezeigt werden soll, müssen Sie die h1.chapter-Formatvorlage anpassen. Ebenso können Sie benutzerdefinierte Formatvorlagen für Unterüberschriften in Ihrem Kapitel erstellen. Wenn Sie beispielsweise eine benutzerdefinierte Formatvorlage für alle Überschriften der 2. und 3. Ebene in Ihrem Kapitel erstellen möchten, müssen Sie eine neue Formatvorlage als "h2.chapter" und "h3.chapter" erstellen.

Da die Funktion "Native PDF-Veröffentlichung" die grundlegenden Formatvorlagendefinitionen für die gängigsten Formatvorlagen enthält, wird die Standardformatvorlage selbst dann auf den Inhalt angewendet, wenn Sie versehentlich eine Formatvorlage löschen. Wenn beispielsweise keine Formatvorlagendefinition für die h2-Formatvorlage in Ihrem Stylesheet vorhanden ist, wendet die Funktion "Native PDF-Veröffentlichung" eine Basisformatvorlage auf h2-Inhalte an.

In diesem Beispiel erstellen wir eine Formatvorlage für Kapitelüberschriften der 2. Ebene:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die "Überschriften-Formatvorlagen".

  3. Klicken Sie mit der rechten Maustaste auf die Formatvorlage in "Überschriften-Formatvorlagen" und wählen Sie "Neue Formatvorlage".

  4. Behalten Sie im Dialogfeld "Formatvorlage hinzufügen" als Tag-Namen "h2" bei, und geben Sie "Kapitel" in das Feld "Klassenname" ein.

  5. Wählen Sie „Fertig“.

Erstellen von Überschriften mit automatischer Nummerierung

Eine der am häufigsten verwendeten Ausgabeformatvorlagen sind automatisch nummerierte Überschriften. Diese Überschriften enthalten die Kapitelnummer, das Thema und die Unterthemennummern. Die automatisch nummerierten Überschriften unterscheiden sich von den Listenformatvorlagen, bei denen einer Liste von Elementen innerhalb eines Themas automatisch Nummern zugewiesen werden.

In diesem Beispiel passen wir die Überschriften von Ebene 1 bis Ebene 3 an, um die automatische Nummerierung in verschiedenen Formaten zu verwenden.

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die "Überschriften-Formatvorlagen".

  3. Wählen Sie die Formatvorlage "h1" aus der Liste.

    Die Eigenschaften für die Formatvorlage "h1" werden im Eigenschaftenbedienfeld zusammen mit der Vorschau angezeigt.

  4. Wählen Sie die Eigenschaft "Automatische Nummerierung" aus. Die Formatvorlagen, die Sie auf die Liste der automatischen Nummerierung anwenden können, werden unter der Eigenschaft "Automatische Nummerierung" angezeigt.

  5. Legen Sie die folgenden Eigenschaften fest:

    • Formatvorlage: Wählen Sie aus einer Vielzahl von gebietsschemaspezifischen oder generischen Formatvorlagen für Nummerierung aus. Sie können Formatvorlagen wie Arabisch-Indisch, Devanagari, Georgisch, Dezimal, "Alphanumerisch, Kleinschreibung" und mehr auswählen. Wählen Sie für das aktuelle Beispiel "Alphanumerisch, Großschreibung" aus.
    • Format: Das Standardformat ist auf <x> festgelegt, wobei der x-Wert durch den Nummerierungsstil ersetzt wird, den Sie in der Formatvorlagen-Eigenschaft ausgewählt haben. Wenn Sie beispielsweise die Dezimal-Formatvorlage (1) ausgewählt haben, wird der Wert von x automatisch für jede Instanz der Formatvorlage "h1" erhöht und lautet 2, 3 usw. Sie können dem Feld auch benutzerdefinierten Text hinzufügen, um die Überschriften-Formatvorlage zu formatieren. Wenn Sie beispielsweise möchten, dass alle h1-Überschriften das Präfix "Kapitel" haben, müssen Sie für dieses Feld "Kapitel
    • <x>" festlegen.
    • Zeichen einfügen: Wenn Sie ein Sonderzeichen im Format hinzufügen möchten, klicken Sie auf das Symbol "Zeichen einfügen". Wählen Sie das gewünschte Zeichen aus, das Sie in der Formatvorlage hinzufügen möchten, und klicken Sie auf "Einfügen". Es gibt verschiedene Arten von Sonderzeichen, die Sie aus der Dropdown-Liste "Kategorie auswählen" auswählen können.

    • Nummerierung beginnen mit: Wenn die Nummerierung mit einer bestimmten Zahl beginnen soll, geben Sie diesen Wert an. Behalten Sie in unserem Beispiel den Standardwert 1 bei.
    • Einzug: Wenn Sie die Überschrift einrücken möchten, müssen Sie den Einzugswert festlegen. Setzen Sie ihn für unser Beispiel auf 0
    • Präfixbreite: Dies ist der Bereich, der vom Format der automatischen Nummerierung belegt wird. Sie wird automatisch auf eine Größe eingestellt, die die ausgewählte Formatvorlage problemlos aufnehmen kann. Wenn Sie die Größe steigern möchten, können Sie den Standardwert ersetzen. Wenn Sie diesen Wert manuell festlegen, versuchen Sie, die anderen Eigenschaften zu ändern, die sich auf die Breite auswirken. Ändern Sie beispielsweise die Schriftgröße, das Format mit Präfix (Kapitel) oder Suffix (:), legen Sie den Maximalwert in der Eigenschaft "Nummerierung beginnen mit" und die verschiedenen Schrifteigenschaften fest, um die optimale Größe zu ermitteln. Behalten Sie für unser Beispiel den Standardwert bei.
    • Abstand: Geben Sie den horizontalen und vertikalen Abstand an. Behalten Sie in unserem Beispiel die Standardwerte bei.
    • Anwenden der Formatierung auf: Die Eigenschaften unter der Kategorie "Automatische Nummerierung" helfen Ihnen bei der Definition der Nummerierungs-Formatvorlage. Um weitere Anpassungen auf die Nummerierungs-Formatvorlage oder den Inhalt Ihres Überschriftenformats anzuwenden, können Sie in diesem Feld "Nummerierung" oder "Absatz" auswählen. Wenn Sie "Nummerierung" auswählen, werden alle Änderungen an "Schriftart","Rahmen", "Layout" und anderen Kategorien nur auf die Nummerierungs-Formatvorlage in der Überschrift angewendet. Wenn Sie jedoch "Absatz" auswählen, werden die Änderungen auf den Überschrifteninhalt und nicht die Nummerierungs-Formatvorlage angewendet.

Verwenden Sie die folgenden Einstellungen, um eine Ausgabe zu generieren, die im folgenden Screenshot gezeigt wird:

Überschriftenformat

Eigenschaft

Wert

h1

Formatvorlage

Dezimal

Format

Kapitel <x>:

Präfixbreite

160 px

Schriftart > Textausrichtung

Links

h2

Formatvorlage

Dezimal

Format

Abschnitt <x>:

Präfixbreite

125 Pixel

Schriftart > Textausrichtung

Links

h3

Formatvorlage

Dezimal

Ebene einfügen

2

Format

Abschnitt <2>.<x>:

Präfixbreite

125 Pixel

Überschriftenformat

Eigenschaft

Wert

Grafische Benutzeroberfläche, Text, Anwendung, emailDescription automatisch generiert

Arbeiten mit Absatzformatvorlagen

Eine Absatzformatvorlage kann erstellt werden, um eine spezielle Formatierung auf einen ganzen Absatz anzuwenden. Mit der Pseudoklasse können Sie eine Formatvorlage jedoch nur auf einen bestimmten Teil des Texts anwenden. Im folgenden Beispiel erstellen wir eine Absatzformatvorlage für die Verwendung der Initialen-Formatvorlage.

Erstellen der Initialen-Formatvorlage

Eine Initialen-Formatvorlage wird in Zeitschriften und literarischen Dokumenten verwendet, in denen das erste Zeichen eines Absatzes oder Abschnitts ein spezielles Styling erhält. Sie können den gleichen Effekt mit der Funktion "Native PDF-Veröffentlichung" erzielen.

Im folgenden Beispiel erstellen wir eine Initialen-Formatvorlage:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die "Absatzformatvorlagen".

  3. Klicken Sie mit der rechten Maustaste auf die Absatzformatvorlage und wählen Sie "Neue Formatvorlage".

  4. Behalten Sie im Dialogfeld "Formatvorlage hinzufügen" als Tag-Namen "p" bei, und wählen Sie im Feld "Pseudoklasse" die Option "::first-letter" aus.

  5. Wählen Sie „Fertig“.

    Eine neue Absatzformatvorlage mit dem Namen "::first-letter" wird erstellt und in der Liste "Absatzformatvorlagen" hinzugefügt.

  6. Wählen Sie unter der Formatvorlage "p" "::first-letter" aus, und legen Sie die folgenden Eigenschaften fest:

    • Schriftart: Legen Sie die gewünschte Schriftart für den ersten Buchstaben in Ihrem Absatz fest. Legen Sie in unserem Beispiel für "Schriftfamilie" Kursivschrift, Schriftstärke 500 und Schriftgröße 30 pt fest und wählen Sie eine Schriftfarbe aus.
    • Layout: Legen Sie die vertikale Ausrichtung des Texts um die Initialen-Formatvorlage fest. Für unser Beispiel werden wir für die vertikale Ausrichtung "Unten" festlegen.

Da das p-Tag mit dem <p>-Element in einem Thema zugeordnet ist, müssen Sie diese Formatvorlage nicht explizit mit dem Klassenattribut hinzufügen. Wo auch immer in Ihren Inhalten ein <p>-Element verwendet wird, wird die Initialen-Formatvorlage automatisch darauf angewendet. Im folgenden Screenshot wurden der Kapiteltitel, die Kurzbeschreibung und die Definitionslistenelemente nicht mit der Initialen-Formatvorlage formatiert. Nur die Absatzformatvorlage wird mit der Initialen-Formatvorlage formatiert:

Arbeiten mit Zeichenformatvorlagen

Mit den Zeichenformatvorlagen können Sie Formatvorlagen zum Formatieren von Zeichen oder Wörtern in Ihrem Inhalt erstellen. Sie können beispielsweise eine Zeichenformatvorlage für Inline-Code oder Dateinamen erstellen, oder eine Formatvorlage erstellen, die mehrere Formatierungen für ausgewählten Inhalt verwendet.

Erstellen einer Inline-Zeichenformatvorlage

Das Formatieren von Inline-Zeichen oder -Wörtern in einem Absatz ist ein sehr gebräuchlicher Stil. Der Erstellungsprozess einer Inline-Formatvorlage umfasst zwei Aufgaben: Erstellen Sie zuerst eine neue Formatvorlage im Stylesheet und wenden Sie zweitens die Formatvorlage mithilfe des Klassenattributs auf Ihren Inhalt an.

Im folgenden Beispiel erstellen wir eine Inline-Zeichenformatvorlage:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die "Zeichenformatvorlagen".

  3. Klicken Sie mit der rechten Maustaste auf die Zeichenformatvorlage und wählen Sie "Neue Formatvorlage".

  4. Behalten Sie im Dialogfeld "Formatvorlage hinzufügen" als Tag-Namen "span" bei, und geben Sie "BoldItalic" in das Feld "Klassenname" ein.

  5. Wählen Sie „Fertig“.

    Eine neue Zeichenformatvorlage mit dem Namen "code" wird erstellt und der Liste "Zeichenformatvorlagen" hinzugefügt.

  6. Wählen Sie "span.BoldItalic" aus der Liste "Zeichenformatvorlagen" und legen Sie die folgenden Eigenschaften fest:

    • Schriftart: Alle schriftartbezogenen Eigenschaften können in diesem Abschnitt angepasst werden. Standardmäßig sind einige Schriftarten im Lieferumfang des Produkts enthalten. Sie können die gewünschte Schriftart als Zeichenformatvorlage wählen. Legen Sie in unserem Beispiel die Schriftfamilie auf "Serif" fest und wählen Sie in der Eigenschaft "Schriftstil" die Option "Fett" und "Kursiv" aus. Sie können auch andere Schriftarteigenschaften anpassen, z. B. Schriftstärke (z. B. fett, heller), Textdekoration (z. B. Unterstreichung, Überstreichung), Schriftgröße, Schriftfarbe, Textausrichtung und mehr.
    • Layout: Sie können layoutbezogene Eigenschaften wie Höhe und Breite, Rand, Abstand, Ausrichtung usw. festlegen.
    • Hintergrund: Mit den Hintergrundeigenschaften können Sie die Hintergrundfarbe einer bestimmten Formatvorlage bestimmen. Sie können die Hintergrundfarbe oder das Hintergrundbild für jede Formatvorlage definieren.

Nachdem Sie die Inline-Zeichenformatvorlage erstellt haben, müssen Sie sie in Ihrem Inhalt anwenden. Um die Inline-Codeformatvorlage anzuwenden, wechseln Sie zur Quellansicht, und fügen Sie die Klasse hinzu.

Attribut im gewünschten Inhalt:

class="BoldItalic"

Das folgende Beispiel zeigt, wie das Format "Fett Kursiv" an verschiedenen Stellen im Fließtext angewendet wird:

Grafische Benutzeroberfläche, Text, Anwendung, E-Mail

Anpassen der Listenformatvorlage

Die Listenformatvorlagen enthalten die Standardstileinstellungen für die sortierten und nicht sortierten Listen. Sie können diese Listenformatvorlagen ganz einfach Ihren Dokumentationsanforderungen anpassen. Im folgenden Beispiel passen wir die nummerierte oder sortierte Listenformatvorlage an:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die "Listenformatvorlagen".

  3. Wählen Sie die Formatvorlage "ol" aus der Liste aus.

    Die Eigenschaften für den ol-Stil werden im Eigenschaftenbedienfeld zusammen mit der Vorschau angezeigt.

  4. Wählen Sie die Option "Erweiterte Formatierung" aus. Eine Bestätigungsnachricht wird angezeigt.

  5. Klicken Sie in der Bestätigungsnachricht auf "Ja", um die "Erweiterte Formatierung"-Eigenschaften zu öffnen.

    Die folgenden Eigenschaften sind standardmäßig verfügbar:

    • Ebene: Standardmäßig sind 6 Ebenen mit nummerierten Listen vorhanden. Die Ebene, die Sie in dieser Dropdown-Liste auswählen, steuert die Formatvorlagenänderungen auf der ausgewählten Ebene und allen nachfolgenden Ebenen. Wenn Sie beispielsweise Ebene 4 auswählen, werden alle angewendeten Formatvorlagenänderungen auf den Ebenen 4, 5 und 6 festgelegt.
    • Listen-Formatvorlagentyp: Sie können aus einer Reihe von Formatvorlagen zur Listennummerierung wählen. Die Liste enthält gebietsschemaspezifische und generische Nummerierungs-Formatvorlagen, die zum Erstellen einer nummerierten Liste verwendet werden. Einige der Listen-Formatvorlagentypen sind Arabisch, Kambodschanisch, Devanagari, Äthiopisch, Hangul, Hebräisch, Japanisch, Koreanisch, Einfaches Chinesisch, Urdu und mehr.
    • Zahlenformat: Das Standardformat ist auf <x> festgelegt, wobei der x-Wert durch die Nummerierungs-Formatvorlage ersetzt wird, die Sie in der Eigenschaft "Listen-Formatvorlagentyp" ausgewählt haben.</x>
    • Wenn Sie beispielsweise die Dezimal-Formatvorlage (1) ausgewählt haben, wird der Wert von x automatisch für jede Instanz des Listenelements erhöht und lautet 2, 3 usw. Sie können dem Feld auch benutzerdefinierten Text hinzufügen, um die Listenformatvorlage zu formatieren. Wenn Sie beispielsweise möchten, dass alle Listenformatvorlagen der ersten Ebene das Suffix ")" haben, müssen Sie für dieses Feld für Listenformatvorlagen der ersten Ebene "<x>)" festlegen.
    • Zeichen einfügen: Wenn Sie ein Sonderzeichen im Zahlenformat hinzufügen möchten, klicken Sie auf das Symbol "Zeichen einfügen". Wählen Sie das gewünschte Zeichen aus, das Sie in der Formatvorlage hinzufügen möchten, und klicken Sie auf "Einfügen". Es gibt verschiedene Arten von Sonderzeichen, die Sie aus der Dropdown-Liste "Kategorie auswählen" auswählen können.
    • Ebene einfügen: Sie können die Zahl aus einer der vorhergehenden Ebenen in Ihr Zahlenformat aufnehmen. Wenn Sie beispielsweise das Zahlenformat von der 5. Ebene in Ihr Zahlenformat der 6. Ebene aufnehmen möchten, wählen Sie in der Dropdown-Liste "Ebene einfügen" die Option "5" aus. Beachten Sie, dass in der Dropdown-Liste "Ebene einfügen" nur die Anzahl der vorhergehenden Ebenen und nicht der folgenden Ebene angezeigt wird. Wenn Sie sich beispielsweise auf Ebene 3 befinden, werden in der Liste "Ebene einfügen" nur die Ebenen 1 und 2 angezeigt.

    Sie können auch das Zahlenformat ändern, um die Listenwerte nach Bedarf darzustellen. Wenn Sie beispielsweise eine verschachtelte Nummerierungs-Formatvorlage für Ebene 3 verwenden, können Sie es als "<2>.<x>))” formatieren. Damit wird Listennummer 2, gefolgt von einem Punkt, dann gefolgt von Listennummer 3 und dann zwei Klammern wie "2.3))" angezeigt.

    • Einzug: Wenn Sie die Liste einrücken möchten, müssen Sie den Einzugswert festlegen. Alle Änderungen am Einzug können im Vorschaufenster überprüft und angepasst werden.
    • Präfixbreite: Dies ist der Bereich, der vom Zahlenformat belegt wird. Er wird automatisch auf eine Größe eingestellt, die das ausgewählte Format problemlos aufnehmen kann. Wenn Sie die Größe steigern möchten, können Sie den Standardwert ersetzen. Wenn Sie diesen Wert manuell festlegen, versuchen Sie, die anderen Eigenschaften zu ändern, die sich auf die Breite auswirken. Ändern Sie beispielsweise die Schriftgröße, das Format mit Präfix oder Suffix und die verschiedenen Schrifteigenschaften, um die optimale Größe zu ermitteln.
    • Abstand: Geben Sie den horizontalen Abstand zwischen dem Listennummernformat und dem Inhalt an. Der vertikale Abstand steuert den Abstand zwischen den beiden Listenelementen.

    Der folgende Screenshot zeigt die benutzerdefinierte sortierte Liste für jede Ebene:

Arbeiten mit der Tabellenformatvorlage

Mithilfe der Stylesheets können Sie eine beliebige Anzahl von Tabellenformatvorlagen entwerfen. Mithilfe der Tabellenformatvorlagen können Sie entwerfen, wie die gesamte Tabelle, eine bestimmte Zeile oder Spalte aussehen soll. Mit der Steuerung der Formatierung auf Zellenebene können Sie sehr attraktive Tabellenformatvorlagen erstellen.

Im folgenden Beispiel sehen Sie das Erstellen einer Tabellenformatvorlage, und welche verschiedenen Optionen der Tabellenformatierung Sie anpassen können:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Klicken Sie in der Liste "Formatvorlagen" mit der rechten Maustaste auf "Tabellenformatvorlage", und wählen Sie "Neue Formatvorlage".

  3. Behalten Sie im Dialogfeld "Formatvorlage hinzufügen" als Tag-Namen "table " bei, und geben Sie "double-border" in das Feld "Klassenname" ein.

  4. Wählen Sie „Fertig“.

Arbeiten mit anderen Formatvorlagen

Wenn Sie mit strukturierten Inhalten (DITA) arbeiten, werden Sie feststellen, dass fast alle DITA-Elemente über eine Formatvorlagenzuordnung im Standard-Stylesheet verfügen. Beispielsweise wird die Formatvorlage eines <shortdesc>-Elements unter "Andere Formatvorlage" > ".shortdesc-Formatvorlagendefinition" definiert. Sie können jede dieser Formatvorlagen ganz einfach anpassen, und sie werden automatisch in der PDF-Ausgabe angewendet, die aus Ihren strukturierten Inhalten generiert wird. Dies bedeutet, dass Sie im Gegensatz zu anderen benutzerdefinierten Formatvorlagen dem Inhalt für diese Formatvorlagen kein Ausgabeklassenattribut hinzufügen müssen.

Wenn Sie eine Formatvorlagendefinition für ein Element erstellen möchten, das standardmäßig nicht verfügbar ist, oder wenn Sie über ein benutzerdefiniertes Element verfügen, können Sie sie ganz einfach im Stylesheet erstellen. Sie müssen nur berücksichtigen, die Formatvorlage mit demselben Namen zu erstellen, den das strukturierte Element hat. Im folgenden Beispiel erstellen wir die Titelformatvorlage (wintitle) eines neuen Fensters:

  1. Öffnen Sie das erforderliche Stylesheet zur Bearbeitung.

  2. Erweitern Sie in der Liste "Formatvorlagen" die Option "Andere Formate".

  3. Klicken Sie mit der rechten Maustaste auf "Andere Formate" und wählen Sie "Neue Formatvorlage".

  4. Behalten Sie im Dialogfeld "Formatvorlage hinzufügen" den leeren Tag-Namen bei, und geben Sie "wintitle" in das Feld "Klassenname" ein.

  5. Wählen Sie „Fertig“.

    Eine neue Formatvorlage mit dem Namen ".wintitle" wird erstellt und der Liste "Andere Formate" hinzugefügt.

  6. Wählen Sie in der Liste "Andere Formate" die Option ".wintitle" aus, und legen Sie die Eigenschaften nach Bedarf fest.

Verwenden von JavaScript zum Arbeiten mit Inhalt oder Stil

Mit der Funktion zum Veröffentlichen der PDF-Ausgabe können Sie JavaScript ausführen, um Ihre Inhalte oder den auf Ihre Inhalte angewendeten Stil zu bearbeiten, bevor die finale PDF generiert wird. Diese Funktion gibt Ihnen vollständige Kontrolle darüber, wie Ihre endgültige Ausgabe generiert wird. Beispielsweise können Sie der PDF-Ausgabe rechtliche Hinweise aus einer anderen PDF hinzufügen. Mit JavaScript können Sie die rechtlichen Hinweise hinzufügen, sobald die PDF für den Basisinhalt erstellt wurde, aber bevor die finale PDF generiert wird.

Um die JavaScript-Ausführung zu unterstützen, bietet die Funktion zum Veröffentlichen der PDF-Ausgabe folgende Rückruffunktionen:

  • window.pdfLayout.onBeforeCreateTOC(callback): Diese Rückruffunktion wird ausgeführt, bevor das Inhaltsverzeichnis generiert wird.
  • window.pdfLayout.onBeforePagination(callback): Diese Rückruffunktion wird ausgeführt, nachdem das Inhaltsverzeichnis generiert wurde, aber bevor Seitenumbrüche in der PDF hinzugefügt werden.
  • window.pdfLayout.onAfterPagination(callback): Diese Rückruffunktion wird ausgeführt, nachdem das Inhaltsverzeichnis und die Seitenumbrüche in der PDF hinzugefügt wurden.
Hinweis:

Intern wird eine Ausführungssequenz für diese Rückruffunktionen beibehalten. Zuerst wird onBeforeCreateTOC ausgeführt, dann onBeforePagination und schließlich onAfterPagination.

Je nach Art des Inhalts oder der Stiländerung, die Sie vornehmen möchten, können Sie auswählen, welche Rückruffunktion verwendet werden soll. Wenn Sie beispielsweise Inhalte hinzufügen möchten, sollten Sie dies vor der Generierung des Inhaltsverzeichnisses tun. Wenn Sie Formatänderungen vornehmen möchten, können sie entweder vor oder nach der Paginierung erfolgen.

Im folgenden Beispiel wird die Position der Abbildungstitel von oberhalb der Bilder zu unterhalb der Bilder geändert. Dazu müssen Sie die JavaScript-Ausführungsoption in der Voreinstellung aktivieren. Führen Sie dazu die folgenden Schritte aus:

  1. Öffnen Sie die Voreinstellung für die Bearbeitung.

  2. Wechseln Sie zur Registerkarte Erweitert.

  3. Wählen Sie JavaScript aktivieren aus.

  4. Speichern Sie die Voreinstellung und schließen Sie sie.

Erstellen Sie als Nächstes eine JavaScript-Datei mit dem folgenden Code und speichern Sie sie im Ordner „Ressourcen“ Ihrer Vorlage:

/*
*	This JavaScript code is used to move the figure title below the image
*	*/

window.addEventListener('DOMContentLoaded', function () { window.pdfLayout.onBeforeCreateTOC(function() {
var titleNodes = document.querySelectorAll('.fig > .title') for (var i = 0; i < titleNodes.length; i++) {
var titleNode = titleNodes[i]
var figNode = titleNode.parentNode
var imageNode = figNode.querySelector('.image') if(imageNode && imageNode.parentNode !== figNode) {
 
imageNode = imageNode.parentNode
}
if (figNode && imageNode && imageNode.parentNode === figNode) { figNode.insertBefore(imageNode, titleNode)
}
}
})
});
Hinweis:

Die Funktion „window.addEventListener('DOMContentLoaded', function()“ muss aufgerufen werden, bevor die Rückruffunktionen verwendet werden.

Als Nächstes muss dieses Skript aus einer Vorlagendatei aufgerufen werden, die zum Generieren der PDF-Ausgabe verwendet wird. In unserem Beispiel werden wir es der Vorlage für das Inhaltsverzeichnis hinzufügen. Stellen Sie sicher, dass das Tag <script> innerhalb eines vordefinierten <div>-Tags im <body>-Tag hinzugefügt wird. Wenn Sie es im <head>-Tag oder außerhalb des <body>-Tags hinzufügen, wird das Skript nicht ausgeführt.

Aktivierung von JSP für PDF-Formatierung

Die Ausgabe wird mithilfe dieses Codes erzeugt, und die Vorlage zeigt den Abbildungstitel unterhalb des Bildes an:

Ausgabe von Format mit JSP-Aktivierung

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?