Herzlich Willkommen

Der decent static site generators (dssg) ist ein Projekt, dass sich aktuell noch in einer frühen Entwicklungsphase befindet. Er ist grundsätzlich schon nutzbar und wird ständig weiterentwickelt. Die Überlassung an Dritte geschieht ohne jegliche Zusage von Eigenschaften und unter Ausschluss jeglicher Haftung.

Der dssg unterliegt dem Urheberrecht und kann für unkommerzielle Projekte jederzeit kostenfrei genutzt werden.

Auf dieser Seite stelle ich hilfreiche Informationen zur Nutzung des zur Verfügung.

Der dssg ist kann als folgendes bezeichnet werden:

• Static Site Generator

• Flat File Content Management System (CMS)

• Flat File Wiki

Der dssg hat folgende Eigenschaften:

• er generiert aus einfachen Markdown Dateien (.md) eine Webseite

• dabei erstellt er automatisch aus den, in Frontmatter (yaml Block am Beginn jeden Dokuments) eingegebenen, Eigenschaften eine Facettensuche

• bei Aktivierung der Geolocation - Funktion wird die Entfernung zu den Einträgen berechnet. Es werden dabei keine Daten an den Server übertragen. Die lokal genutzten Daten für die Berechnung werden nach jeder Session gelöscht.

• er unterstützt eine Auswahl an Formatierungen aus der Markdown Syntax

• er unterstützt eine einfache Wiki Syntax zur internen und externen Verlinkung

• er integriert Foto's und Video's in die Webseite

Diese Instanz ist zum Kennenlernen mit einigen Übungsdaten gefüllt. Einfach oben in die Suchleiste klicken und los geht's.

Create your own site - Erstelle Deine eigene dssg-Webseite

Auf jeder Instanz des dssg befindet sich am unteren linken Rand ein Button "Create your own site" mit der jede/r seine eigene Webseite aus einem Ordner mit Markdowndateien kreieren kann. Nach der Bestätigung des Einverständnisses, wird auf dem lokalen Rechner aus dem ausgewählten Ordner mit .md Dateien eine statische Webseite generiert. Alle notwendigen Daten für die Webseite befinden sich dann in dem Ordner website und müssen nur noch per SFTP in den Webspace hochgeladen werden. Jede auf diese Weise generierte Webseite enthält ebenso diese Funktion.

Der dssg auf dieser neu erstellten Instanz wird allerdings nicht automatisch upgedatet!! Der dssg auf dieser Webseite ist nach Möglichkeit auf dem neuesten Stand.

Dabei gilt folgendes:

1.

Es muss vor der Erstellung der Webseite zwingend eine index.md (Kleinschrift) Datei innerhalb des Hauptordners angelegt werden. Diese index.md braucht in den Properties die Eigenschaft "title: Überschrift der Startseite"

2.

Zur einfacheren Orientierung innerhalb der .md Dateien, können Unterordner angelegt werden. Die Suchfunktion wird dadurch nicht beeinträchtigt.

3.

Um die Auswahlfelder der Facettensuche übersichtlich zu halten, erscheint eine Eigenschaft erst im Suchmenü, wenn sie 5 mal benutzt wurde. Natürlich findet man über die Suchmaske alle Dateien.

Nähere Informationen zum Handling der .md Dateien und dem dssg befinden sich in der Einführungshilfe.

Der Quellcode befindet sich auf Sourcehut.

Im Januar 2024

Andreas Artmann

Kontakt: dssg@andreas-artmann.de

dssg Version 0.1.49

Datenschutzerklärung Impressum