Turnen SpVgg Weil im Schönbuch e. V.

blog/ – Blogbeiträge schreiben

Alles, was du zum Anlegen eines neuen Beitrags brauchst. Du musst dafür nichts programmieren – ein Ordner, eine Markdown-Datei, ein paar Bilder.

Neuen Beitrag anlegen

Lege unter src/blog/posts/ einen neuen Ordner an und darin eine Datei namens index.md:

src/blog/posts/2026-09-21_Herbstwanderung/index.md

Der Ordnername folgt immer dem Muster JJJJ-MM-TT_Titel-Slug.

Wichtig: Das Datum kommt aus dem Ordnernamen – nicht aus dem Front Matter. Es bestimmt, in welcher Reihenfolge die Beiträge auf /blog/ und auf der Startseite erscheinen (neueste zuerst). Schreib also kein date: ins Front Matter, sondern benenne den Ordner richtig.

Haben zwei Beiträge dasselbe Datum, entscheidet der Ordnername (alphabetisch) über die Reihenfolge – also eher zufällig. Bei mehreren Beiträgen am selben Tag lohnt sich ein Blick auf featured (siehe unten).

Front Matter

Ganz oben in der index.md steht der Block zwischen den ----Zeilen:

---
title: Herbstwanderung 2026
author: Erika Musterfrau
heroUrl: "./img-0.jpeg"
---

Hier beginnt der eigentliche Text …
Feld Pflicht Beschreibung
title ja Überschrift des Beitrags.
author ja Wer den Beitrag geschrieben hat. Mehrere Namen sind okay: Melina Müller & Julia Krebs.
heroUrl nein Titelbild für die Vorschau-Karte auf der Startseite. Relativer Pfad, z. B. "./img-0.jpeg".
featured nein false = Beitrag erscheint nicht auf der Startseite (siehe unten). Ohne Angabe: erscheint.
subtitle nein Untertitel. Wird nicht automatisch angezeigt – du musst ihn im Text selbst einbauen (siehe unten).
originalTitle nein Ursprüngliche, meist längere Überschrift. Reine Notiz, wird nirgends angezeigt.

tags und permalink nicht angeben – die kommen automatisch aus posts/posts.json und gelten für alle Beiträge.

Wenn du subtitle nutzt, füg ihn als erste Zeile im Text ein:

---
title: Winterwanderung 2025
subtitle: Ein gelungener Start ins Jahr
author: Alexander Hübner-Hecker
---

****

Am Sonntag trafen sich …

Beiträge nicht auf der Startseite zeigen

Auf der Startseite wird im Abschnitt „Aktuelles aus der Abteilung" immer genau ein Beitrag angezeigt: der neueste. Manchmal passt das nicht – etwa bei einer kurzen Notiz oder einem Bericht, der nur eine einzelne Gruppe betrifft.

Dann setzt du im Front Matter:

---
title: Turnwettkampf der Jungs in Kuppingen
author: Daniela Kienzle
featured: false
---

Der Beitrag steht dann weiterhin ganz normal auf /blog/ – nur die Startseite überspringt ihn und zeigt stattdessen den nächstälteren Beitrag. Sonst ändert sich nichts.

Bilder

Bilder liegen im selben Ordner wie die index.md:

src/blog/posts/2026-09-21_Herbstwanderung/
├── index.md
├── img-0.jpeg
└── img-1.jpeg

Im Text bindest du sie relativ ein – also mit ./ davor:

![Vier Turnerinnen stehen nebeneinander auf der Wiese und halten ihre Urkunden hoch.](./img-0.jpeg)

Beim Bauen der Seite werden diese Pfade automatisch in die richtigen Adressen umgeschrieben (dafür sorgt fixPostLinks in eleventy.config.js). Schreib deshalb keine absoluten Pfade wie /blog/posts/... – das geht schief.

Bitte gute Alt-Texte schreiben. Der Text in den eckigen Klammern beschreibt das Bild für Menschen, die es nicht sehen können. Ein ganzer Satz, der beschreibt, was zu sehen ist – nicht nur „Bild" oder „Foto". Als Vorbild kannst du dir posts/2026-02-19_Vereinsmeisterschaften-2026/index.md anschauen.

Beiträge haben keine eigene Seite

Blogbeiträge bekommen bewusst keine eigene URL (permalink: false in posts.json). Sie werden vollständig auf /blog/ und auf der Startseite eingebettet. Du kannst also nirgends auf einen einzelnen Beitrag verlinken – immer nur auf /blog/.

Vorschau

npm start ausführen und unter http://localhost:8080/ nachschauen: