Skip to main content

Inhaltsverzeichnis (HTML5)

Für die HTML5-Ausgabe gibt es drei Arten von Inhaltsverzeichnissen (TOC), die Sie kombinieren können:

  1. TOC-Seitenleiste: Im linken Bereich der Portalseite befindet sich die Hauptnavigation und zeigt den Publikationsinhalt an.

  2. Abschnitts-Inhaltsverzeichnis: Dieses befindet sich am Ende jedes Topics (es trägt die Bezeichnung In diesem Abschnitt) und zeigt die Subtopics außerhalb des Topics, siehe Aktivieren des Abschnitts-Inhaltsverzeichnisses.

    Eine weitere Option ist ???; sie erscheint in einem „Siehe auch“-Abschnitt am Ende eines Topics.

  3. Seiten-Inhaltsverzeichnis: Dieses befindet sich auf der rechten Seite eines jeden Topics und zeigt dessen Subtopics, siehe Aktivieren von Seiten-Inhaltsverzeichnissen. Dies hebt die Titel hervor, wenn Sie durch das Topic scrollen.

TOC_HTML5_small.jpg

Tipp

Das Element titleabbrev ist nützlich, wenn die Titel lang sind, Sie jedoch kürzere Titel im Inhaltsverzeichnis (PDF), auf der Seitenleiste des Inhaltsverzeichnisses (HTML5) und für Querverweise bevorzugen, siehe Verwenden von Titelabkürzungen.

Das HTML5-Helpcenter-Layout verfügt über eine einklappbare TOC-Funktion, mit der Sie eine Ausgabe mit einer einklappbaren TOC-Seitenleiste erstellen können.

Wenn diese Einstellung aktiviert ist, erstellt Paligo ein Helpcenter mit einem „Hamburger“-Menü. Benutzer können das Menü auswählen, um das linke Feld, welches das Inhaltsverzeichnis enthält, einzuklappen und auszuklappen.

Die Funktion einklappbares TOC ist für HTML5-Helpcenter konzipiert, die das Thema 2 verwenden (siehe Themes für HTML5-Help Center). Wenn Sie ein anderes Thema verwenden, müssen Sie möglicherweise ein benutzerdefiniertes CSS verwenden, um das Styling zu ändern, siehe Formatieren mit CSS.

Close up of Paligo logo in top-left of help center. There is a three line "hamburger" menu icon to the left of the logo.

Menü „Hamburger“

HTML5 help center output using Theme 2. The left side of the page has a side panel containing the table of contents.
HTML5 help center output using Theme 2. The left side of the page has no side panel or table of contents. It has been collapsed so that the content takes up the available space.

Wählen Sie das Hamburger-Menü-Symbol, um die TOC-Seitenleiste einzuklappen und auszuklappen.

So richten Sie eine einklappbare TOC-Seitenleiste für die HTML5-Ausgabe ein:

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.

    Tipp

    Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.

  3. Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.

    TOC_and_Chunking_Menu.jpg
  4. Stellen Sie einklappbares TOC auf:

    • Aktivieren, um die Funktion einklappbares TOC zu aktivieren

    • Deaktivieren, um die Funktion einklappbares TOC zu deaktivieren

    • Standard – um den Wert für diese Einstellung aus dem Basislayout zu übernehmen. Das Basislayout kann ein von Paligo bereitgestelltes integriertes Layout oder ein anderes kundenspezifisches Layout ein. Weitere Informationen finden Sie unter Layoutbeziehungen – Basis, Neu, Duplizieren.

  5. Drücken Sie Speichern.

Wenn Sie mit diesem Layout veröffentlichen, wird Paligo Ihre Auswahl auf die Ausgabe anwenden.

Verwenden Sie das HTML5-Helpcenter-Layout, um zu steuern, wie die Einträge der oberen Ebenen in Ihrem Inhaltsverzeichnis aussehen können:

  • Ausgeklappt, um Einträge der unteren Ebene sichtbar zu machen

  • Eingeklappt, um die Einträge der unteren Ebenen auszublenden

Standardmäßig werden Einträge der oberen Ebenen ausgeklappt, wenn ein Benutzer auf das Chevron für den Eintrag oder den Titel des Eintrags klickt. Es wird jedoch nur dann wieder eingeklappt, wenn der Benutzer das Chevron auswählt.

Wenn Sie es bevorzugen, können Sie die Einträge der oberen Ebenen so einstellen, dass sie sich ausklappen und einklappen, wenn ein Benutzer das Chevron oder den Titel auswählt.

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.

    Tipp

    Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.

  3. Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.

    TOC_and_Chunking_Menu.jpg
  4. Verwenden Sie Abschnitt im TOC einklappen, wenn auf den Link-Titel geklickt wird, um das Einklappverhalten zu steuern. Es gibt die folgenden Optionen:

    • Aktivieren, um das TOC so einzustellen, dass es aus- und eingeklappt wird, wenn der Benutzer einen Eintragstitel oder ein Chevron auswählt.

    • Deaktivieren, um das TOC so einzustellen, dass es ausgeklappt wird, wenn der Benutzer ein Chevron oder einen Titel auswählt, aber nur einklappt, wenn das Chevron ausgewählt wird. Wenn Sie den Titel erneut auswählen, wird das TOC nicht eingeklappt.

    • Standard – um den Wert für diese Einstellung aus dem Basislayout zu übernehmen. Das Basislayout kann ein von Paligo bereitgestelltes integriertes Layout oder ein anderes kundenspezifisches Layout ein. Weitere Informationen finden Sie unter Layoutbeziehungen – Basis, Neu, Duplizieren.

  5. Drücken Sie Speichern.

Wenn Sie mit diesem Layout veröffentlichen, wendet Paligo die von Ihnen gewählten Einstellungen an.

Fügen Sie ein Seiten-TOC (Inhaltsverzeichnis) hinzu, um die Unterüberschriften jeder Seite anzuzeigen. Die Überschriften werden hervorgehoben, wenn Sie durch das Topic scrollen. Diese Funktion ist nur für die HTML5-Helpcenter-Themes 1 und 2 verfügbar (nicht für die „Preloaded“-Version).

Um zu vermeiden, dass Überschriften sowohl in der Inhaltsverzeichnis-Seitenleiste als auch im Seiten-Inhaltsverzeichnis erscheinen, sollten Sie zusammen mit dem Seiten-Inhaltsverzeichnis auch die Option „Nur Chunks in Inhaltsverzeichnisse aufnehmen“ aktivieren. Das bedeutet, dass nur diejenigen Topics, die (gemäß Ihren Einstellungen) zu Chunks werden, in die TOC-Seitenleiste aufgenommen werden. Beispielsweise werden interne Abschnittselemente eines Topics nicht in die Seitenleiste eines Inhaltsverzeichnisses, sondern nur in das Seiten-Inhaltsverzeichnis aufgenommen.

Page_TOC_small.jpg

So aktivieren Sie das Seiten-Inhaltsverzeichnis für HTML5:

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.

    Tipp

    Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.

  3. Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.

    TOC_and_Chunking_Menu.jpg
  4. Wählen Sie Aktivieren um die Option Nur Chunks in Inhaltsverzeichnisse aufnehmen zu aktivieren.

    Die verschachtelten Topics bzw. die Topic-Unterabschnitte werden von der Inhaltsangaben-Seitenleiste ausgeschlossen. Diese werden stattdessen in das Seiten-Inhaltsverzeichnis aufgenommen.

    Only_Include_Chunks_in_TOC_small.jpg

    Standardmäßig ist diese Funktion deaktiviert.

  5. Wählen Sie Aktivieren, um die Verwendung des Seiten-Inhaltsverzeichnisses zu aktivieren.

    Use_Page_TOC_small.jpg

    Standardmäßig ist diese Funktion deaktiviert.

  6. Drücken Sie Speichern.

[en] Paligo has a Section TOC feature for adding a table of contents (TOC) inside each topic. In HTML5 outputs, the TOC has a heading called "In this section" containing links to each subsection in the topic. The links are created and managed automatically by Paligo.

Section_TOC_small.jpg

So aktivieren oder deaktivieren Sie die Verwendung von Abschnitts-Inhaltsverzeichnissen:

[en] For instructions for PDF, see Abschnitt-TOCs einrichten (PDF).

So aktivieren oder deaktivieren Sie die Verwendung von Abschnitts-Inhaltsverzeichnissen:

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.

    Tipp

    Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.

  3. Wählen Sie eine der drei Optionen aus dem Menü:

    1. Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.

      TOC_and_Chunking_Menu.jpg
    2. Scrollen Sie nach unten zur Option für das Verwenden des Abschnitts-Inhaltsverzeichnisses.

      • Danach: Erzeugt eine hierarchische Liste von Subtopics unterhalb des Topics. Standard

        Use_section_toc_After.jpg
      • Davor: Erzeugt eine hierarchische Liste von Subtopics zwischen dem Topic-Titel und seinem ersten Absatz.

        Use_section_toc_Before.jpg
      • Keine: Deaktiviert das Abschnitts-Inhaltsverzeichnis.

  4. Drücken Sie Speichern.

Wenn Sie das Abschnitts-Inhaltsverzeichnis in bestimmten Themes verbergen möchten, können Sie ein Skript zu Ihrem CSS hinzufügen und das Rollenattribut mit dem Wert no-section-toc zu den betreffenden Topics hinzufügen.

Wenn Sie veröffentlichen, bleibt der Inhaltsverzeichnis-Abschnitt für die Topics mit dem Wert no-section-toc verborgen, er wird jedoch für die übrigen Topics angezeigt.

  1. Fügen Sie Ihrer benutzerdefinierten CSS-Datei Folgendes hinzu:

    .no-section-toc ~ .footer-content .section-toc
     {display: none;}
  2. Laden Sie Ihre benutzerdefinierte CSS-Datei in Ihr Paligo-Layout, siehe Hochladen benutzerdefinierter CSS.

  3. Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternativ können Sie Topics erstellen und dieses bearbeiten.

  4. Wählen Sie den Abschnitt im Menü „Elementstruktur“ und wählen Sie Gehe zu Element.

    Close-up of element structure menu. The section element is selected revealing a menu. The go to element option is highlighted in the menu.
  5. Fügen Sie das Attribut role im Panel „Elementattribute“ hinzu.

  6. Legen Sie den Wert no-section-toc fest.

    No_Section_TOC_Value.jpg
  7. Drücken Sie Speichern. Save icon.

  8. Wiederholen Sie die Schritte 3 bis 7 für alle Themen, die im Abschnitts-Inhaltsverzeichnis verborgen sein sollen.

Sie können sich dafür entscheiden, nummerierte Überschriften wie beispielsweise „1.2 Einschalten des Geräts“ in Ihre HTML5-Ausgabe aufzunehmen.

In der Regel wenden Sie die Nummerierung auf alle Abschnitte an (indem Sie Allgemein > TOC und Chunking > Abschnittsnummerierung in Layout-Editor aktivieren), oder Sie verwenden überhaupt keine nummerierten Überschriften.

Es kann jedoch vorkommen, dass Sie eine Mischung aus nummerierten und nicht-nummerierten Überschriften benötigen. Dafür können Sie das Elementattribut-Label verwenden, dessen Wert auf 0 gesetzt ist.

Wenn Sie Topics veröffentlichen, die dieses Elementattribut verwenden, wendet Paligo keine Nummerierung auf die Überschrift an, auch wenn die Publikation auf die Verwendung nummerierter Überschriften festgelegt ist. Die Überschrift erscheint als reiner Text, sowohl im Topic als auch im Inhaltsverzeichnis.

So verhindern Sie die automatische Nummerierung eines Topic:

  1. Wählen Sie das Topic oder die Komponente im Content Manager aus, um es/sie im Editor zu öffnen.

    Content Manager in Paligo. It shows the Documents section contains an Acme 100 Topics folder. Inside the folder there is a publication and many topics, including "Connect to Network (100).

    Alternativ können Sie Topics erstellen und dieses bearbeiten.

  2. Wählen Sie das section-Element im Menü „Elementstruktur“ aus.

    Close up of Element Structure Menu. It shows the section element is selected and the Go to element option is selected.
  3. Wählen Sie Zu Element wechseln aus.

  4. Fügen Sie das Attribut label im Panel „Elementattribute“ hinzu.

    Element attributes panel. The section element is selected and a label attribute has been added. The value of the label attribute is zero.

    Der Wert 0 weist Paligo an, diesen Abschnitt nicht zu nummerieren.

  5. Legen Sie den Wert auf 0 fest.

  6. Drücken Sie Speichern. Save icon.

Anmerkung

Um die Nummerierung erneut zu aktivieren, entfernen Sie das Attribut label.

Für Ihre HTML- und HTML5-Ausgaben müssen die HTML-Dateien auf das Inhaltsverzeichnis (TOC) der Publikation verweisen. Hierfür gibt es zwei Möglichkeiten:

  • Fügen Sie das Inhaltsverzeichnis in jede HTML-Datei ein. Dies minimiert die Nutzung von JavaScript, führt jedoch zu größeren HTML-Dateien.

  • Trennen Sie den Inhaltsverzeichnis von den HTML-Dateien und verwenden Sie JavaScript, um das Inhaltsverzeichnis einzufügen, wenn jede HTML-Seite angezeigt wird. Dies ist effizienter, da die HTML-Dateien kleiner sind und daher schneller geladen werden, was unter dem SEO-Aspekt (Search Engine Optimization) vorteilhafter ist.

Um zu festzulegen, wie Paligo das Inhaltsverzeichnis einschließt, verwenden Sie die Eigenständiges-Inhaltsverzeichnis-Einstellung für HTML- und HTML5-Layouts:

  1. Wählen Sie im oberen Menü Layout aus.

    Paligo editor. The Layout option in the header menu is highlighted.

    Paligo zeigt eine Liste von Layouts an. Die Liste ist leer, wenn keine benutzerdefinierten Layouts in Ihrer Paligo-Instanz vorhanden sind.

  2. Wählen Sie das Layout, das Sie aktualisieren möchten, oder Ein Layout erstellen aus.

    Tipp

    Sie können die URL des Layout-Editors kopieren und in eine neue Registerkarte in Ihrem Browser einfügen. Dies kann nützlich sein, wenn Sie häufig zwischen Ihren Paligo-Inhalten und den Layout-Einstellungen wechseln.

  3. Wählen Sie in der Seitenleiste Inhaltsverzeichnis und Chunking aus.

    TOC_and_Chunking_Menu.jpg
  4. Legen Sie für Eigenständige Inhaltsverzeichnisse eine der beiden folgenden Optionen fest:

    Standalone TOC setting on a layout. It has a dropdown menu with options for Default, Disable and Enable.
    • Aktivieren: Wenn JavaScript zum Einfügen des Inhaltsverzeichnisses aus einer separaten Datei verwendet werden soll. Dies ist effizienter, da die HTML-Dateien kleiner sind und daher schneller geladen werden, was unter dem SEO-Aspekt vorteilhafter ist. Empfohlen

    • Deaktivieren: Wenn das Inhaltsverzeichnis in jede HTML in der HTML/HTML5-Ausgabe aufgenommen werden soll. Dies minimiert die Nutzung von JavaScript, führt jedoch zu größeren HTML-Dateien.

    • Standard – um den Wert für diese Einstellung aus dem Basislayout zu übernehmen. Das Basislayout kann ein von Paligo bereitgestelltes integriertes Layout oder ein anderes kundenspezifisches Layout ein. Weitere Informationen finden Sie unter Layoutbeziehungen – Basis, Neu, Duplizieren.

    In der Regel ist es besser, die Eigenständiges-Inhaltsverzeichnis-Funktion zu aktivieren, doch in einigen Fällen kann dies zu unerwünschten Ergebnissen führen. Zum Beispiel, wenn Ihr Hilfeportal so konfiguriert ist, dass die Nutzung von Javascript minimiert wird. Dies kann auch dazu führen, dass Ihr Hilfe-Port für ältere Suchmaschinenbots weniger gut zugänglich ist.

  5. Drücken Sie Speichern.

Wenn Sie veröffentlichen, wendet Paligo Ihre Auswahl auf die Ausgabe an.