1. Vorbereitung auf Deinem iMac
- Terminal öffnen
- Finder → Programme → Dienstprogramme → Terminal. Dort gibst du Textbefehle ein.
- Ruby-Version prüfen
ruby -v – mindestens Version 2.7
- Homebrew installieren
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2. Jekyll & Bundler installieren
- Installieren
gem install --user-install bundler jekyll
- Pfad ergänzen
export PATH="$HOME/.gem/ruby/3.x.x/bin:$PATH" in ~/.zshrc oder ~/.bash_profile
- Testen
jekyll -v → sollte eine Versionsnummer anzeigen
3. Neues Blog-Projekt anlegen
- In Dokumente wechseln
cd ~/Dokumente
- Projekt erstellen
jekyll new mein-blog
- Projekt öffnen
cd mein-blog
4. Lokalen Server starten
- Startbefehl
bundle exec jekyll serve
- Seite ansehen
http://localhost:4000
- Live-Vorschau
- Änderungen werden automatisch übernommen
5. Blog-Beiträge schreiben
- Datei im richtigen Ordner anlegen
-
Jekyll erwartet deine Beiträge im Ordner
_posts. Der Dateiname folgt dem Format:
Jahr-Monat-Tag-titel.md
Beispiel: 2025-08-07-mein-erster-beitrag.md
- YAML-Frontmatter einfügen
-
Dieser sogenannte "Kopfbereich" steht ganz oben in der Datei und sieht so aus:
---
layout: post
title: "Mein erster Beitrag"
date: 2025-08-07 10:00:00 +0200
---
- Inhalt schreiben mit Markdown
-
Darunter folgt dein Beitragstext. Jekyll nutzt Markdown – eine einfache Schreibweise für Formatierungen:
# Überschrift → große Überschrift
**fett** → fetter Text
*kursiv* → kursiver Text
- Listenpunkt → Aufzählung
- Beitrag speichern
-
Speichere die Datei. Wenn dein Jekyll-Server läuft, kannst du sie direkt im Browser sehen.
6. Beiträge ansehen & den Server stoppen
- Im Browser ansehen
http://localhost:4000/mein-erster-beitrag.html
- Beenden
Strg + C im Terminal
7. Tipps für alle – leicht und zugänglich
- Größere Schrift
- Terminal → Einstellungen → Schriftgröße erhöhen
- Dateien bearbeiten
- TextEdit oder Visual Studio Code – einfache Textbearbeiter
- Hilfe holen?
- Kein Problem! Mach ein Foto vom Fehler, frag Freunde oder online