feat(docs): Landingpage mit Projektübersicht

[raifdmueller]

Was sich ändert

Die Startseite war die Platzhalter-Seite des docToolchain-Themes — „Solution Architecture Documentation for System X". Sie sagte nichts über dieses Projekt.

Neu: eine Übersicht, die den Generator erklärt.

• Hero — ein Quelltext, alle Formate; mit Abkürzung für Leute, die nur ein Template wollen (→ arc42.org/download)
• Pipeline — die vier Phasen Generate → Discover → Convert → Package
• Sechs Karten — je ein Dokument der Recovery, mit einem Satz, was drinsteht
• Build — wie man die Templates baut und wie diese Seite entsteht

Sie nutzt die CSS-Klassen des Themes (dtc-hero, dtc-card, dtc-pipeline), driftet also optisch nicht weg.

Wo die Datei liegt

site/doc/landingpage.gsp, nicht docs/site/.... microsite.siteFolder löst relativ zu docs/ auf; mit '../site' bleibt das Template außerhalb der veröffentlichten Seite. Innerhalb von docs/ wird es als Asset mitkopiert und landet als site/doc/landingpage.gsp im Output — nachgemessen und deshalb verschoben.

Der Workflow-Check greift jetzt wirklich

Beim Entwickeln ist genau das passiert, wogegen EPIC 1 des Backlogs antritt: generateSite meldet Erfolg, obwohl das Template nicht geparst werden konnte.

Failed to parse template script ... token recognition error at: '/' @ line 133, column 35

Ein /^[A-Z]{2,}$/ im Fließtext — die GSP-Engine las $ als Expression-Start, der Include scheiterte, und der Build lief grün weiter. Die index.html existierte, war aber inhaltsleer; der bisherige Check test -s index.html hätte das durchgewunken.

Der Check sucht jetzt nach Landing-Inhalt statt nur nach einer nicht-leeren Datei:

grep -q 'dtc-landing' "$index" || {
  echo "::error::index.html carries no landing page content - ..."
  exit 1
}

Test

generateSite:  0 Fehler, Landingpage aktiv, alle sechs Kartenlinks zeigen auf existierende Seiten
Output:        keine .gsp-Streudatei mehr unter output/site/
Guard:         PASS gegen die lokal gebaute index.html

🤖 Generated with Claude Code

https://claude.ai/code/session_014S4btgSH36ViayKLqGLd6G

---

Generated by Claude Code