Einführung

lowmark ist ein Flat-File-Website-Generator, der Markdown-formatierte Texte in Webseiten umwandelt. Im Unterschied zu anderen Flat-File-Systemen liegt der Fokus auf der Einfachheit des Systems, das aus wenigen php-Skripten besteht und auch mit Programmier-Grundkenntnissen und dieser Dokumentation vollständig verstanden und an die eigenen Bedürfnisse angepasst werden kann.

Das „Backend“

Diese Einfachheit wird erreicht, in dem lowmark sich ganz darauf konzentriert – oder man könnte auch sagen „beschränkt“ – lokal verfasste Inhalte im Internet zu publizieren. Du schreibst Deine Texte in Markdown mit einem Editor Deiner Wahl auf Deinem Endgerät. Sofern es eingebettete Dokumente wie Bilder und Downloads gibt, bettest Du sie auch direkt lokal in Deine Markdown-Datei ein. Du hast also lokale, direkt lesbare Dokumente in einem äußerst datensparsamen und plattformübergreifend funktionierenden zukunftssicheren Format.

Dieser Ansatz spart einerseits das Backend (Programmieraufwand/Komplexität) und sorgt anderseits dafür, dass Deine Inhalte unabhängig von dem CMS Bestand haben. Diesen Ansatz hat lowmark mit statischen Website-Generatoren wie z.B. HUGO gemeinsam.

Das Grundkonzept

Anders als bei statischen Website-Generatoren wird die Website aber „on the fly“ gerendert. Es ist also kein separater Build-Prozess nötig. Du überträgst Deine Markdown-Datei einfach auf den Webserver und schon kann sie als Webseite abgerufen werden. lowmark verzichtet auch auf ein Caching der Seiten. Das Konzept besteht darin, dass um eine Seite im Browser anzuzeigen, nur auf genau eine Markdown-Datei zugegriffen werden muss. Das Rendern dieser einen Seite läuft so effizient, dass ein dynamischer Cache keinen signifikanten Performance-Gewinn bringen würde.

Templates

lowmark verwendet standardmäßig nur ein Template: index.php. Als „Template-Sprache“ dient direktes Inline-PHP. Bei Bedarf lässt sich das System erweitern, um unterschiedliche Templates für verschiedene Anwendungsfälle zu nutzen.

Bildskalierung

lowmark bietet eine dynamische Bildskalierung um zu gewährleisten, dass eingebettete Bilder automatisch auf eine schlanke klimafreundliche Dateigröße reduziert werden.

Seiten-Indizierung

Um Blogs und ähnliche Anwendungsfälle abzudecken, bietet lowmark Komponenten für Timelines, RSS-Feeds und Tags. Ermöglicht wird dies durch eine automatische Seiten-Indizierung.

Shortcodes

Es gibt die Option, zusätzliche Komponenten als Shortcodes zu integrieren. Die Syntax ist kompatibel mit gängigen Shortcode-Notationen (HUGO, markdoc, Jekyll und pandoc). Es ist daher möglich, mit nur geringem Anpassungsaufwand Content von einem statischen Website-Generator zu lowmark zu portieren.

Der Seiten-Index und die Timeline-Komponente sind z.B. auch als Shortcodes realisiert, damit die strenge Einfachheit des lowmark-Cores gewahrt bleibt.

Zur Vertiefung