Skip to content

Custom Pages DE

Domekologe edited this page Jun 30, 2026 · 1 revision

Custom Pages

🌐 English · Deutsch

Mit Custom Pages kann der Bot-Owner zusätzliche Markdown-basierte Seiten zum Dashboard hinzufügen – Regeln, FAQs, Changelogs, Links, beliebiges. Der Editor unter /pages hat eine Live-Vorschau, jede Seite kann öffentlich oder privat sein, und gespeicherte Seiten erscheinen sofort in der Navigation. Inhalte werden über einen bewusst sicheren Markdown-Renderer gerendert, es gibt also keine Roh-HTML-/XSS-Fläche.

Screenshot: der Custom-Pages-Markdown-Editor mit Live-Vorschau

Anlegen und bearbeiten

Öffne /pages (Bot-Owner). Pro Seite legst du fest:

Feld Bedeutung
Slug Das URL-Fragment – die Seite liegt unter /p/<slug>. Leerzeichen werden zu Bindestrichen, kleingeschrieben.
Titel In der Navigation und als Seitenüberschrift gezeigt.
Markdown Der Seiteninhalt in Markdown, mit Live-Vorschau daneben.
Sichtbarkeit public (alle) oder private (nur eingeloggte Nutzer).
Nav Ob die Seite in der Navigation erscheint.

Beim Speichern wird die Seite im Cog abgelegt (übersteht Neustarts und wird über alle Dashboard-Instanzen geteilt, die auf denselben Bot zeigen).

Öffentlich vs. privat

  • Öffentliche Seiten sind ohne Login unter /p/<slug> erreichbar – gut für Regeln oder öffentliche Infos.
  • Private Seiten werden nur für eingeloggte Nutzer gerendert.

Die Sichtbarkeit wird beim Abruf der Seite serverseitig erzwungen, nicht nur im Menü versteckt.

Sofortige Navigation

Die Navigation lädt die Seitenliste aus dem Cog (mit kurzem Cache). Nach dem Speichern oder Löschen erscheint bzw. verschwindet die Seite sofort im Menü und in der Befehlspalette – ohne Rebuild oder Neustart.

Sicheres Markdown-Rendering

Seiten und die Live-Vorschau rendern vollständiges GitHub-Flavored Markdown:

  • Inline: fett, kursiv, durchgestrichen, Inline- & Codeblock-code, Links plus Autolinks für nackte URLs sowie Bilder.
  • Block: Überschriften, geordnete/ungeordnete Listen, Aufgabenlisten (- [ ] / - [x]), Tabellen (mit Spaltenausrichtung), Zitatblöcke und Trennlinien.
  • GitHub-Hinweise: > [!NOTE], > [!TIP], > [!IMPORTANT], > [!WARNING] und > [!CAUTION] werden als farbige Callouts dargestellt.

Roh-HTML wird aus Sicherheitsgründen escaped (XSS-sicher), eingebettete HTML-Tags werden also nicht gerendert. Dadurch können Custom Pages keine Skripte oder beliebiges Markup einschleusen – sie sind sicher öffentlich zeigbar. (Derselbe Renderer wird auch andernorts genutzt, z. B. für Audit-Details.)

Screenshot: eine gerenderte öffentliche Custom Page

Verwandte Seiten

Clone this wiki locally