Markdown & Custom CSS
Nutzungsbedingungen
Custom CSS wird ohne Support und ohne Gewähr bereitgestellt. Für Funktion, Kompatibilität und Wartung individueller Stylesheets sind ausschliesslich die Nutzer:innen verantwortlich. Wenn kleio Updates durchführt, musst du deine Änderungen überprüfen.
Ins Style Sheet kommst du wie folgt:
- Öffne deine Website-Einstellungen
- Gehe auf Darstellungsoptionen > Anpassen
- Drücke alt (option) und shift
- Es zeigt sich dann ganz unten eine Taste “Custom CSS Editor einblenden”
Markdown
Unser Markdown-Parser orientiert sich weitgehend an den GitHub Flavored Markdown (GFM) Spezifikationen. Ausnahmen von der Spezifikation sind auf der Website des Parsers unter GitHub Flavored Markdown dokumentiert, allerdings teilweise schwer verständlich. Für allgemeine Hinweise kann die Standard Markdown-Syntax als Orientierung dienen.
Zeilenumbrüche
Einzelne Zeilenumbrüche werden automatisch als <br> umgesetzt. Dieses Verhalten lässt sich direkt in der Vorschau nachvollziehen.
Erweiterungen
- Definition Lists: Werden unterstützt.
- HTML-Code: Reiner HTML-Code kann ebenfalls eingebunden werden. Sowohl geparstes Markdown als auch HTML werden vor der Anzeige bereinigt.
Bereinigung von HTML und CSS
Die Bereinigung erfolgt durch die Library js-xss unter Verwendung von getDefaultWhitelist mit einigen Anpassungen. So werden z. B. style-Attribute zugelassen, ohne dass deren Inhalt verändert wird.
Whitelist der erlaubten HTML-Tags und Attribute
Hinweise
- Externe Bilder können eingebettet werden. Bilder von internen Quellen (z. B. kleio) ohne öffentliche Verfügbarkeit lassen sich nicht über Markdown einbinden.
- Aktuell gibt es keine Einschränkungen bei den erlaubten Domains für
iframe.
Custom CSS
Custom CSS wird grundsätzlich unterstützt, allerdings gibt es einige Einschränkungen:
- Änderungen der HTML-Struktur können nicht automatisch von User*innen nachverfolgt werden. Wer Custom CSS nutzt, muss seinen öffentlichen Space regelmässig prüfen und gegebenenfalls Anpassungen vornehmen.
- Der Custom CSS Code wird vor der Anzeige bereinigt, sollte aber alle aktuellen CSS-Regeln akzeptieren.
- Eine vollständige Dokumentation der HTML-Struktur existiert nicht, die Struktur ist jedoch einfach genug, dass individuelles Umstyling möglich ist.
Die Struktur ändert sich nur selten, daher können einmal erstellte Custom CSS-Regeln in der Regel langfristig verwendet werden.
Wir übernehmen keine Garantie für individuelle Anpassungen im Stylesheet. Wenn kleio ein Update durchführt, müssen die Nutzer*innen diese selbst prüfen und gegebenenfalls anpassen.