So entsteht ein Beitrag
Dieser Beitrag ist gleichzeitig die Anleitung für alle weiteren. Wer ihn nicht mehr
braucht, löscht die Datei content/beitraege/so-entsteht-ein-beitrag.md und baut die
Seite neu.
Einen neuen Beitrag anlegen
Ein Beitrag ist eine Textdatei im Ordner content/beitraege/. Der Dateiname wird zur
Adresse: aus gartenjahr-2026.md wird /beitraege/gartenjahr-2026/. Deshalb keine
Umlaute und keine Leerzeichen im Dateinamen verwenden.
Oben in der Datei stehen drei Angaben zwischen zwei Linien aus drei Strichen:
---
title: "Überschrift des Beitrags"
description: "Ein Satz, der in der Übersicht unter dem Titel steht."
date: 2026-09-20
---
Darunter folgt der Text in Markdown. Eine Leerzeile trennt Absätze, ## macht eine
Zwischenüberschrift, *Wort* kursiv und **Wort** fett. Ein Link sieht so aus:
[Beschriftung](https://beispiel.de).
Bilder
Bilder gehören nach static/bilder/. Ein Bild static/bilder/hecke.jpg wird im Text
so eingebunden:
Große Fotos vorher verkleinern. Der Anschluss nach draußen schafft 27 Mbit/s im Upload, ein 8-Megabyte-Bild lässt einen Besucher also gut zwei Sekunden warten, bevor überhaupt etwas zu sehen ist. Ein Bild von 1600 Pixel Breite reicht für jeden Bildschirm.
Ansehen und veröffentlichen
Beim Schreiben hilft die Vorschau. Sie zeigt jede Änderung sofort im Browser:
./site-deploy.sh -v
Wenn es passt, kommt die Seite mit einem Befehl auf den Pi:
./site-deploy.sh
Danach ist sie unter http://192.168.164.20 zu sehen. Der Befehl überträgt nur, was
sich geändert hat, und räumt gelöschte Seiten weg.
Was diese Seite bewusst nicht kann
Keine Kommentare, keine Suche, keine Anmeldung. Alles davon bräuchte ein Programm, das auf dem Pi läuft und gepflegt werden will. Hier liegen nur fertige Dateien, und genau deshalb ist an dieser Stelle nichts kaputtzugehen.