Teil 7 Beiträge und Kategorien anlegen

Beitrag anlegen und Metadaten

Das Programmgerüst Ihres eigenen Content Management Systems steht und kann jetzt mit Inhalt gefüllt werden - also Content wie man heutztage auch sagt. Da Beitragsdaten und Kategoriebeschreibungen letztendlich das identische YAML/MD-Format nutzen, werden sie gleichartig behandelt. Die interne Struktur folgt einem festen Schema, es ist eine clevere Kombination aus YAML-Struktur und Markdown-Format.

MVC Design Pattern: Die Beiträge

Mit Hilfe der YAML-Struktur wird im Kopfbereich die Attributierung durch einige Metadaten eingeleitet und der Beitrag kategorisiert. Dadurch wird später beispielsweise eine Sortierung nach Datum oder Titel möglich, da diese Felder für einen späteren sort() verwendet werden können. Das Markdownformat ist der etablierte Standard der Webredakteure und Content-Creators, denn er ermöglich die schnelle Erstellung von Beitragstexten ohne HTML-Kenntnisse.

Alle Beitragstexte (beitrag-xyz.md) und Kategoriebeschreibungen (index.md) haben den folgenden strukturellen Aufbau:

–––
Title:       Titel
Date:        2024-02-01
Author:      Oliver Lohse
Logo:        /img/logo.svg
Description: Beschreibung und Anleser
–––
Das ist die interne Struktur jedes Beitrags und Index Ihres CMS. Der Beitrag folgt damit 
der **YAML**-Syntax und kann mit Hilfe der **Markdown**-Syntax formatiert werden. Markdown
ist die Sprache der Webredakteure und Content-Creators, da sie schnell und unkompliziert
verwendet werden kann.

Beispiel einer geöffneten Beitragsdatei

Im unteren Teil der YAML-Struktur erscheint der eigentliche Beitragstext, der mit Hilfe der Markdown-Syntax verfasst werden kann. Dieser Teil wird dem Template-Token {content} zugewiesen.

Einen Beitrag anlegen

Sie können neue Beiträge wie übliche Dateien anlegen und verarbeiten, Sie müssen sich jedoch an einige Namenskonventionen halten, dazu einige Beispiele:

content/music/dawid-bowie.md
content/music/the-cure.md
content/music/depeche_mode.md

gültige Beitragsformate

sind erlaubte Dateinamen, hingegen sind die folgenden Dateinamen nicht erlaubt:

content/music/david bowie.md
content/music/the cure is great!!!.md

ungültiges Beitragsformat

Sie können alle regulären ASCII Zeichen der Zahlen und Buchstaben nutzen, dürfen jedoch keine Sonderzeichen, Leerzeichen oder Umlaute verwenden. Das CMS würde dies mit einem Fehler quittieren.

Eine Kategorie anlegen

In diesem kleinen Content Management System können Sie so viele Kategorien (Verzeichnisse unterhalb von content) anlegen und ineinander verschachteln wie Sie mögen. In jeder Kategorie muss die Datei index.md existieren, die eine Beschreibung der Kategorie aufnimmt. Die Datei index.md ist im Aufbau absolut identisch mit einem regulären Beitrag.

content/music/index.md

Kategorie anlegen

Oben sehen Sie die Kategoriebeschreibung die zwingend in der index.md hinterlegt sein muss.

Einen passenden Editor

Da das kleine CMS traditionelle ASCII-Dateien verwendet, werden keine großen Ansprüche an den Editor gestellt. Beiträge können mit fast allen Editoren erstellt werden, jedoch funktionieren Word oder ähnliche Textverarbeitungen nicht als Editor, da diese unsichtbare Formatierungen im Text hinterlassen, die den Parser stören. Eine gute Wahl ist das kostenlose Visual Studio Code aber auch andere wie jEdit funktionieren sehr gut.

Oliver Lohse
2024-02-10
ein eigenes CMS entwickeln programmieren
post
0