Bereiche einrichten
Name, Adresse, Symbol, Art, Leseansicht und die weiteren Einstellungen eines Bereichs.
Neue Bereiche legst du in der Seitenleiste mit Neuer Bereich an. Die Einstellungen eines bestehenden Bereichs öffnest du über das Zahnrad neben dem Bereichsnamen (oberhalb der Seitenliste). Dafür brauchst du im Bereich die Rolle Bereichs-Admin (Workspace-Admins haben sie immer).
Beim Anlegen
| Feld | Bedeutung |
|---|---|
| Symbol | Eines der Symbole aus der Auswahl – erscheint in der Verwaltung und auf der Website |
| Name | Anzeigename, z. B. „Handbuch“ |
| Adresse | Erster Teil der URL (/handbuch/…). Leer lassen = automatisch aus dem Namen |
| Beschreibung | Kurzer Text für Startseite und Bereichsübersicht |
| Art | Dokumentation, Changelog oder API-Referenz – lässt sich später nicht ändern |
| Sichtbarkeit | Siehe Sichtbarkeit |
| Passwort (nur bei Passwortschutz) | Nur nötig bei Passwortgeschützt |
| Sprache | Hauptsprache der Inhalte (Deutsch, English, Français, Español, Italiano, Nederlands) |
Einstellungen eines Bereichs
Allgemein – Symbol, Name, Adresse und Beschreibung. Achtung: Eine geänderte Adresse bricht bestehende Links auf den Bereich.
Zugriff – Sichtbarkeit, Passwort, die Rolle für Workspace-Mitglieder und die Review-Pflicht. Details in Sichtbarkeit, Rollen und Änderungsanfragen.
Leseansicht – was Leser neben dem Text sehen:
- Inhaltsverzeichnis rechts
- Zurück/Weiter-Links am Seitenende
- „War das hilfreich?“-Feedback (Auswertung unter Statistik & Feedback)
Nach dem Speichern wird der Bereich neu generiert.
Teilen & Rollen – Personen und Gruppen Zugriff geben, siehe Mitglieder & Gruppen.
Versionen – den aktuellen Stand einfrieren, siehe Versionen & Sprachen.
Freigabe-Links – nur bei nicht-öffentlichen Bereichen, siehe Freigabe-Links.
OpenAPI-Spezifikation – nur bei Bereichen der Art API-Referenz, siehe OpenAPI-Referenz.
Changelog-Bereiche
Ein Changelog-Bereich zeigt datierte Einträge, die neuesten zuerst, und bietet unter
/<bereich>/feed.xml einen RSS-Feed an. Im Editor hat jede Seite eines Changelog-Bereichs zusätzlich ein Feld
Datum.
Statt die Einträge von Hand anzulegen, kannst du eine CHANGELOG.md importieren (per CLI oder
REST-API). Docsello versteht Abschnitte der Form ## 1.2.0 – 2026-10-01 (auch
„Keep a Changelog“: ## [1.2.0] - 2026-10-01) mit Unterüberschriften wie ### Neu, ### Verbessert,
### Behoben bzw. ### Added, ### Changed, ### Fixed. Jede Version wird ein Eintrag; ein erneuter Import
aktualisiert nur, was sich geändert hat. Abschnitte „Unreleased“ werden standardmäßig übersprungen.