Blog Builder
Helfen Sie dem Nutzer, einen persönlichen Blog zu starten – von der Framework-Auswahl bis zum Live-Deployment mit korrekter SEO. Vollständiger Umfang: Framework-Wahl -> Theme -> Beitragsvorlage -> Deployment -> SEO.
Workflow
Schritt 1 – Nutzerkontext verstehen
Fragen Sie (oder leiten Sie aus dem Kontext ab):
- Technischer Hintergrund? (nicht-technisch / JS-Entwickler / Python-Entwickler / etc.)
- Neustart oder bereits bestehende Website?
- Bevorzugtes Deployment-Ziel: GitHub Pages, Vercel, Cloudflare Pages?
- Inhaltlicher Fokus: Schreiben, Portfolio, Tutorial-Blog, Dokumentation?
Schritt 2 – Framework empfehlen
| Situation | Empfohlen |
|---|---|
| Nicht-technisch, möchte nur schreiben | Hugo – kein JS, schnell, riesige Theme-Bibliothek |
| Schreibt bereits JS/TS, möchte Komponenten-Kontrolle | Astro – Insel-Architektur, hervorragende DX |
| Liebt Theme-Ökosysteme, fühlt sich mit Node wohl | Hexo – ausgereiftes Plugin-Ökosystem |
| React-Entwickler, möchte volle Kontrolle | Next.js – App Router + MDX |
Präsentieren Sie die Empfehlung mit einer kurzen Begründung. Vor dem Fortfahren bestätigen lassen.
Schritt 3 – Framework einrichten
Lesen Sie die entsprechende Referenzdatei und führen Sie den Nutzer durch die Installation + ein Starter-Theme:
| Framework | Referenzdatei |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
Schritt 4 – Beitragsvorlage erstellen
Erstellen Sie eine sofort nutzbare Beitragsvorlagendatei mit vollständigem Frontmatter. Die Vorlagen unter assets/post-templates/ sind Ausgangspunkte – passen Sie sie an das gewählte Theme und die Präferenzen des Nutzers an.
Schritt 5 – Deployment
Lesen Sie references/deployment.md für den passenden CI/CD-Workflow. Stellen Sie das vollständige GitHub Actions-YAML bereit, bereit zum Einchecken.
Wichtige Hinweise:
- GitHub Pages: Pushen nach .github/workflows/deploy.yml; Pages in den Repository-Einstellungen aktivieren
- Vercel: Repository im Dashboard verbinden; Framework-Voreinstellung und Ausgabeverzeichnis festlegen
- Cloudflare Pages: Build-Befehl = npm run build, Ausgabeverzeichnis = dist (Astro/Hexo/Next.js) oder public (Hugo)
Schritt 6 – SEO-Konfiguration
Jeder Blog braucht:
- sitemap.xml – framework-spezifisch; siehe references/.md
- robots.txt – tatsächlichen Dateiinhalt bereitstellen, nicht nur eine Beschreibung
- Open-Graph-Tags – og:title, og:description, og:image, og:url als tatsächliches Markup
- Kanonische URLs – baseURL/site in der Konfiguration setzen, damit Sitemaps und OG-Tags korrekt funktionieren
Immer darauf hinweisen: Die Site-URL muss in der Framework-Konfiguration gesetzt sein, damit die Sitemap korrekte absolute URLs generiert.
Leitprinzipien
- Tatsächlichen Dateiinhalt (Code, YAML, TOML) bereitstellen, nicht nur Beschreibungen
- Nur die relevanten Felder einfügen – überwältigendes Boilerplate vermeiden
- Auf die ein oder zwei typischen Fallstricke hinweisen, die Anfänger verwirren (z. B. Hugo baseURL, Astro site-Feld)
- Kopierfertige Beispiele bevorzugen