From e0a5791afb78630ffdbf149787e52fe760c0b89b Mon Sep 17 00:00:00 2001
From: Kalina <kalina@kalina.si>
Date: Mon, 2 Nov 2026 18:46:57 +0100
Subject: [PATCH] docs(assets): Herkunft der Vorschaubilder dokumentiert

Wie vorschau.png, vorschau-shell.png und logo-platte.png entstehen (Vorlage bauen, echter qterminal auf Xvfb, WeasyPrint-Komposition) und wie man sie nachzaehlt statt begutachtet.
---
 assets/VORSCHAU.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 assets/VORSCHAU.md

diff --git a/assets/VORSCHAU.md b/assets/VORSCHAU.md
new file mode 100644
index 0000000..e33bb95
--- /dev/null
+++ b/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.
-- 
2.43.0