Merge pull request 'Herkunft der Vorschaubilder' (#5) from docs/vorschau-herkunft into main

Herkunft der Vorschaubilder

assets/VORSCHAU.md

@@ -0,0 +1,44 @@
+# Vorschaubilder
+
+Die Bilder auf der Startseite sind **erzeugt, nicht gemalt**. Wer sie erneuert, baut sie neu —
+und prüft dabei die Farben, statt sie zu behaupten.
+
+## `vorschau.png` (1200 × 630)
+
+Zusammengesetzt aus zwei echten Erzeugnissen dieses Repos:
+
+1. **Deckblatt** — `templates/report.html` mit ausgefüllten Platzhaltern, gebaut über
+   `tools/kalina-pdf build bericht.html -o bericht.pdf` (die Prüfung muss grün sein), dann
+   `pdftoppm -png -r 140 -f 1 -l 1 bericht.pdf ber`.
+2. **Terminal** — ein echter `qterminal` mit dem CI-Schema auf einem eigenen Display:
+   `Xvfb :77`, `XDG_DATA_DIRS=$HOME/.local/share/qterminal-ci:…`, Fenster per `xdotool`
+   beschriften, `xwd` dumpen, die 20 px Menüleiste oben abschneiden.
+
+Danach beide Bilder in ein HTML im Maß 1200 × 630 px setzen (Grund `#0B0F14`, Wortmarke
+`assets/kalina-wordmark.svg`, Fußlinie mit den Token-Werten) und über WeasyPrint rendern:
+
+```bash
+weasyprint vorschau.html vorschau.pdf && pdftoppm -png -r 96 vorschau.pdf v
+```
+
+## `vorschau-shell.png` (880 px breit)
+
+Nur das Terminal-Bild, gleicher Weg. Gezeigt wird der Prompt aus `shell/prompt.zsh` mit dem
+Zeitsegment (dauert eine Eingabe ≥ 2 s, erscheint `· 2.4s`).
+
+## `logo-platte.png`
+
+`assets/logo.png` auf `#F5F5EF` gesetzt (`-trim`, 22 px Rand). Nötig, weil die Marke in Tinte
+gezeichnet ist und auf einem dunklen Theme sonst verschwindet — die Platte trägt sie auf beiden.
+
+## Gegenprobe
+
+Nach dem Erzeugen nicht auf das Auge verlassen, sondern zählen:
+
+```bash
+convert vorschau-shell.png -format %c -depth 8 histogram:info:- | sort -rn | head -3
+```
+
+Der Grund muss `#0B0F14` sein (über 85 % der Fläche), der Text `#F5F5EF`, Rot `#C1121F`
+beziehungsweise `#E0454F` nur als Akzent. Erscheint Weiß oder Schwarz als häufigste Farbe,
+ist die Palette nicht geladen — dann nicht abschneiden, sondern die Ursache suchen.