Seitenleiste steuern

Die Seitenleiste ist das linke Navigationsfenster Ihrer Docsbook-Dokumentationswebsite: der Seitenbaum sowie eine optionale Suche, Breadcrumbs, eine Sprachauswahl und seitenspezifische Symbole. Jede Einstellung hier ist eine Anzeigeoption und wird nicht auf Ihr Projektguthaben angerechnet.

Einstellungen der Seitenleiste#

So konfigurieren Sie die Seitenleiste#

1. Öffnen Sie Ihre Dokumentationswebsite.
2. Float Widget → Design → Registerkarte Linke Seitenleiste.
3. Aktivieren Sie die gewünschten Optionen.
4. Speichern Sie.

Seitenleiste von der Seite aus bearbeiten#

Vieles von dem, was folgt, kann auch geändert werden, ohne das Einstellungsfenster überhaupt zu öffnen. Drücken Sie auf Ihrer Dokumentationsseite in der Symbolleiste auf Editor und klicken Sie dann auf den Eintrag in der Seitenleiste, den Sie ändern möchten. Darüber wird eine kleine Aktionsleiste mit folgenden Optionen angezeigt:

• Umbenennen — ändern Sie die in der Seitenleiste angezeigte Bezeichnung.
• Symbol — wählen Sie ein Symbol aus, beschreiben Sie das gewünschte oder entfernen Sie es.
• Analytics — fragen Sie, was die Leser tatsächlich mit dieser Seite machen.

Durch das Umbenennen hier wird nur die Bezeichnung geändert. Die Seite behält ihre Adresse, sodass alle Links, die auf sie verweisen — aus Ihren eigenen Dokumenten, von Google oder aus dem Blog einer anderen Person — weiter funktionieren. Wenn Sie die URL selbst ändern möchten, benennen Sie die Datei stattdessen in Ihrem Repository um.

Jede Aktion wird als Anfrage an den KI-Chat gesendet, der sie anschließend anwendet. Sie sehen, was angefragt wurde und was geändert wurde, und können in derselben Unterhaltung „mach das rückgängig“ sagen.

Sprachumschalter in der Seitenleiste#

Der Sprachumschalter in der Seitenleiste ist eine Sprachauswahl, die im linken Bereich angezeigt wird, damit Leser zwischen Übersetzungssprachen wechseln können.

Wann sollte er verwendet werden: Aktivieren Sie ihn, wenn Ihre Kopfzeile bereits mit anderen Elementen überladen ist.

Hinweis: Aktivieren Sie entweder den Umschalter in der Seitenleiste oder die Sprachauswahl in der Kopfzeile — nicht beides. Die Anzeige an zwei Stellen führt zu Redundanz.

Mindestens eine Übersetzungssprache muss aktiviert sein. Bis dahin wird beim Öffnen des Umschalters auf Ihrer eigenen Website Sprachen aktivieren angezeigt, wodurch Sie direkt zu den Übersetzungseinstellungen gelangen. Ihre Leser sehen stattdessen den einfachen Hinweis Keine Sprachen hinzugefügt. Übersetzungen einrichten →

Suche in der Seitenleiste#

Die Suche in der Seitenleiste ist ein Suchfeld, das im linken Seitenleistenbereich Ihrer Docsbook-Website angezeigt wird.

Dies ist eine Alternative zur Suchschaltfläche im Header. Einige Leser bevorzugen die Suche in der Seitenleiste, weil sie den Seiteninhalt nicht verdeckt.

Mehr über Suchoptionen →

Breadcrumbs#

Breadcrumbs zeigen den Speicherort der aktuellen Seite in Ihrer Dokumentation als Pfad oberhalb des Seitentitels:

Home > Guides > Custom Domain

Breadcrumbs helfen Lesern in umfangreichen Dokumentationsseiten, zu verstehen, wo sie sich befinden, und schnell eine Ebene nach oben zu navigieren.

Empfohlen: Aktivieren Sie Breadcrumbs für Dokumentationen mit mehr als 20 Seiten oder mehreren verschachtelten Abschnitten.

Symbole der Seitenleiste#

Fügen Sie neben jeder einzelnen Seite oder jedem Ordner in der linken Seitenleiste ein Symbol hinzu, damit Leser den Baum visuell statt nur anhand der Bezeichnung durchsuchen können.

So konfigurieren Sie es

1. Öffnen Sie Ihre Dokumentationswebsite.
2. Float Widget → Design → Registerkarte Linke Seitenleiste.
3. Suchen Sie in der Karte Symbole der Seitenleiste nach der Seite oder dem Ordner, den Sie markieren möchten, und wählen Sie anschließend ein Lucide-Symbol dafür aus (z. B. rocket, book-open).
4. Wiederholen Sie den Vorgang für weitere Seiten oder Ordner.
5. Speichern Sie.

Der Auswahlbereich bietet nur Symbolnamen aus dem aktuellen Lucide-Symbolsatz an – durch die Suche nach einem Namen (z. B. „rocket“, „book“, „folder“) können Sie die Ergebnisse eingrenzen. Eine Symbolzuweisung gilt für eine Seite oder einen Ordner; weisen Sie das Symbol eines Ordners separat von den darin enthaltenen Seiten zu.

Wann Sie diese Funktion verwenden sollten: Symbole helfen Lesern, wichtige Bereiche (Erste Schritte, API-Referenz, FAQ) in einer langen oder tief verschachtelten Seitenleiste auf einen Blick zu erkennen. Für eine kleine Dokumentationswebsite mit nur wenigen Seiten auf oberster Ebene sind Symbole optional.

Unterheader-Ordner#

Unterheader-Ordner verwandeln jeden Ordner der obersten Ebene eines Repositorys in einen eigenen Tab im Unterheader – der Tab-Leiste, die auf Dokumentationsseiten unterhalb des Hauptrheaders angezeigt wird. Jeder aktivierte Ordner kann außerdem ein Lucide-Symbol auf seinem Tab tragen.

So konfigurieren Sie die Funktion

1. Öffnen Sie Ihre Dokumentationsseite.
2. Gehen Sie zu Float Widget → Design → Registerkarte Header.
3. Aktivieren Sie in der Karte Unterheader-Ordner alle Ordner der obersten Ebene, die als Unterheader-Tabs angezeigt werden sollen.
4. Optional können Sie auf die Symbolschaltfläche neben einem aktivierten Ordner klicken, um ein Lucide-Symbol für dessen Tab auszuwählen (oder Symbol entfernen, um ein bereits festgelegtes Symbol zu löschen).
5. Speichern Sie.

Ein im Unterheader angezeigter Ordner kann unabhängig davon in der linken Seitenleiste ausgeblendet oder dort beibehalten werden. Verwenden Sie dafür den entsprechenden Umschalter in der Karte Ordnersichtbarkeit neben Unterheader-Ordnern.

Ein Ordner ist davon ausgenommen: Erste Schritte bleibt immer in der Seitenleiste, und sein Umschalter ist dauerhaft aktiviert. Dorthin kehrt ein Leser zurück, der die Einführung vorzeitig schließt. Wenn der Ordner ausgeblendet würde, gäbe es für ihn keine Möglichkeit zurückzukehren.

Verwandte Themen#

• Header-Layout und Navigation — die obere Leiste und die andere Stelle, an der der Sprachumschalter platziert werden kann
• Suchoptionen — wonach das Suchfeld in der Seitenleiste sucht
• Übersetzungseinstellungen — die Sprachen, die der Umschalter anbietet
• Theming — hell, dunkel, System — die andere Stelle, an der der Theme-Umschalter platziert werden kann