Tutorial für dieses CMS

Ich habe das Repository nun veröffentlicht und ihr findet es bei Codeberg zum Angucken, herunterladen und verbessern. Tatsächlich werdet ihr aber garantiert mit einem 404-Fehler begrüßt, denn es müssen noch einige Kleinigkeiten gemacht werden.

home.md anlegen

Im Ordner /content musst du eine Datei namens home.md anlegen, die quasi die Startseite darstellt. Der Aufbau jeder Content-Seite ist gleich: Es gibt im Ordner "content" ein Unterverzeichnis und darin ist dann die Datei.

Dateien / Texte anlegen

Wie ich schon oben schrieb, die Inhalte sind alle im Ordner "content" hinterlegt. Die Kategorie bestimmt der Ordnername. Wenn du also eine Inhaltsseite machen willst, die in der Kategorie "linux" aufgeführt wird, erstellst du einfach im Ordner content den Ordner "linux" und dann die Datei.

content/linux/titel-des-artikels.md

Das CMS erkennt dann sofort, dass die Datei da ist und zeigt sie im Frontend an. Also zumindest, wenn der Aufbau der Markdown-Datei richtig ist.

Aufbau des Textfiles

---
title: Tutorial für dieses CMS
date: 2025-12-16 10:23:31
template: page.html.twig
image: /wp-content/uploads/schimar.webp
categories: ["software", "cms"]
---

##  Zweite Headline

Content-Text in Standard-Markdown. Yay

Jede CMS-Seite wird mit einem Frontmatter-Header versehen. Da wird der Seitentitel eingetragen, welches Twig-Template die Seite verwenden soll und wo ein eventuelles Header-Bild hinterlegt ist. Dann natürlich noch das Datum und die Kategorien, zu denen der Post gehört. Das mit den Kategorien ist aber tatsächlich ein Relikt aus meinem Wordpress-Import. Da waren Posts nach Datum sortiert und erst danach nach Kategorien.

Ich will hier aber einen Magazincharakter, also hinterlege ich Content lieber in die entsprechenden Ordner.

Content schreiben

Jetzt, wo du weißt, wie die Datei aufgebaut sein muss, kannst du einfach eine Markdown-Datei erstellen und dann simpel per FTP oder SSH hochladen. Das war's. Mehr ist nicht zu tun. Das CMS erkennt die neue Datei und zeigt sie automatisch auch an.