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

Herkunft der Vorschaubilder

CHANGELOG.md

@@ -11,6 +11,9 @@ versioniert.
   `themes/kalina-ci-dark.json`: Tinte `#0B0F14`, Knochenweiß `#F5F5EF`, Markenrot `#C1121F`
   nur als Grafik, Text-Rot `#E0454F` (4,70:1), Salbei `#7FA88C` nur an Git. Ausgerollt auf vier
   Maschinen (Arbeitsplatz, Laptop, iMac, Gast-VM); die Pixelprobe zeigt auf jeder `#0B0F14`.
+- **Die Startseite traegt Vorschaubild und Marke.** `assets/vorschau.png` (1200 × 630) zeigt
+  Deckblatt, Prompt und Token in einem Bild; `assets/vorschau-shell.png` steht im Shell-Abschnitt,
+  `assets/logo-platte.png` ist die Marke auf Knochenweiss (lesbar auf hellem wie dunklem Gitea).
 - **`shell/install.sh` richtet weitere Maschinen ohne meinen Zugriff ein.** Idempotent, sichert
   jede Datei nach `.vor-kalina-ci-<stempel>`, erkennt foot, qterminal, xfce4-terminal und xterm
   und prüft anschließend mit `zsh -n`, `foot --check-config` und `xrdb`-Query. Aufruf per

README.md

@@ -1,3 +1,5 @@
+![KALINA](assets/logo-platte.png)
+
 # KALINA CI
 
 Corporate Identity der KALINA als versioniertes Artefakt: eine Satzvorlage (CSS),
@@ -6,10 +8,12 @@ die alle drei Wege bedient — und seit 1.3.0 dieselbe Farbwelt für Shell und T
 **Ein Dokument, das nach KALINA aussehen soll, nimmt diese Dateien — keine nachgebauten
 Farben, kein selbst gezeichnetes Logo.**
 
+![Vorschau: Deckblatt aus der Vorlage, Prompt in der Shell, Token in der Fußlinie](assets/vorschau.png)
+
 ```
 css/kalina-ci.css          Satzvorlage: @page A4, Kopfleiste, Tabellen, Plakette, Fußlinie
 templates/                 report.html · page.html · bild-mit-prompt.html
-assets/                    kalina-mark.svg · kalina-wordmark.svg · kalina-logo-combined.svg · favicon/
+assets/                    Marke als SVG (mark · wordmark · combined · favicon) + Vorschaubilder
 scripts/stamp_existing_pdf.py   fremdes PDF mit Deckblatt/Marke/Fußzeile versehen
 shell/install.sh           Shell-Prompt und Terminal-Palette auf einer Maschine einrichten
 shell/prompt.zsh           zsh-Prompt als eigenständiges Modul (kein oh-my-zsh, kein p10k)
@@ -51,6 +55,8 @@ Prompt, Terminal-Palette, ein Skript für beides.
 └─ ❯
 ```
 
+![Der Prompt in einem Terminal mit CI-Palette](assets/vorschau-shell.png)
+
 ```bash
 curl -fsSLo install.sh https://gitea.m-m.bio/mm/kalina-ci/raw/branch/main/shell/install.sh
 bash install.sh --dry-run   # zeigt, was passieren würde

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.