2025-08-10
Cascading-Style-Sheets sind natürlich das Mittel der Wahl für mehr oder weniger komplexe Gestaltungen.
mdmachine nutzt automatisch (wenn nicht anders konfiguriert) die folgenden CSS-Dateien von meiner Domain:
Außerdem werden nach Bedarf Style-Schnipsel in die HTML-Dateien eingefügt.
Im mdmachine-Verzeichnis medien finden sich Dateien,
deren Namen mit style.txt enden. Eine Datei zu Demonstration lautet
user_demo_style.txt. Deren Inhalt kann man per Parameter im
YAML-Block einer Markdown-Datei einbinden:
m²_include_style: demo
Der Inhalt wird am Ende der HTML-Datei eingefügt - also nicht als
CSS-Datei eingebunden. Er muss korrektes HTML darstellen, wird also z.B.
mit <style> beginnen.
Damit wird das originale CSS ergänzt, nicht überschrieben. Es gelten die üblichen Regeln der Browser für aufeinanderfolgende, ggf. widersprüchliche oder unterschiedlich konkrete CSS-Definitionen. Die Webmastertools der Browser helfen hier.
Entsprechend kann auch jede von dir angelegte Datei
user_xyz_123_style.txt mit
m²_include_style: "xyz_123"
eingebunden werden. Nur Kleinbuchstaben, Unterstrich und Ziffern werden
akzeptiert. Arrays sind möglich:
m²_include_style: [demo, "xyz_123"]
Gibt man den Parameter stattdessen in der mdm_root.yaml
an, so wird dieser in dem gesamten Verzeichnisbaum für die Verarbeitung
von Markdowndateien angewandt. Reihenfolge: Erst die Styles aus
mdm_root, dann die aus dem YAML-Block der individuellen Datei um erstere
noch übersteuern zu können.
Anmerkung: mdmachine wird auch zukünftig keine weiteren user_xxx_style.txt enthalten, so dass eigene Dateien vor Überschreiben sicher sind.
Du kannst die von mir verwendeten CSS-Dateien komplett ersetzen,
indem du ihre URLs in der mdm_root.yaml angibst. Siehe dort.
Natürlich ist es empfehlenswert auf den bestehenden Dateien aufzubauen.