104 lines
3.8 KiB
Markdown
104 lines
3.8 KiB
Markdown
```
|
|
BAUSTEIN-CARD-STIL (HTML+CSS, in Browser anzeigbar)
|
|
|
|
ZWECK
|
|
- Einzelner Baustein als kompakte Card-Darstellung
|
|
- Schnelles Nachschlagen einzelner Konzepte
|
|
- Card ist Teil einer größeren Baustein-Sammlung
|
|
- Nicht zum Lernen, sondern zum Wiedererkennen
|
|
- Pro Card genau 1 Baustein
|
|
|
|
FORMAT
|
|
- HTML mit eingebettetem CSS
|
|
- Im Browser anzeigbar (kein PDF-Output)
|
|
- Card auf hellgrauem Hintergrund zentriert
|
|
- Max-width 1000px, padding 28px 36px
|
|
- Border-radius 12px, dezenter Schatten
|
|
- Page-Hintergrund #f0f0f5
|
|
|
|
STRUKTUR — STRIKT NUR DIESE 4 ELEMENTE
|
|
1. Titel (h1, fett, ohne Label, ohne Logo)
|
|
2. Beschreibung (ein knapper Satz)
|
|
3. Zweck (kursiv, grau, ein knapper Satz)
|
|
4. Code-Beispiele (untereinander, mit Mini-Label oben)
|
|
|
|
KEIN Logo, KEIN "Baustein"-Label, KEIN Sprach-Tag, KEINE Sektion-Überschriften ("Beschreibung", "Zweck", "Relevante Beispiele"), KEINE Info-Blöcke, KEINE Warn/Tip/Note-Boxen, KEINE Meta-Informationen, KEINE Trennlinien zwischen Sektionen.
|
|
|
|
TYPOGRAFIE
|
|
- Body: -apple-system, "Segoe UI", sans-serif, 14px, line-height 1.5
|
|
- Titel h1: 28px, font-weight 800, letter-spacing -0.5px, line-height 1.1
|
|
- Beschreibung: 14px, line-height 1.55
|
|
- Zweck: 14px, italic, color #5a6470
|
|
- Code: "SF Mono", Consolas, monospace, 12px, line-height 1.5
|
|
- Code-Label: 10px, uppercase, letter-spacing 1px
|
|
|
|
FARBEN
|
|
- Card-Hintergrund: #ffffff
|
|
- Page-Hintergrund: #f0f0f5
|
|
- Text: #1a1a1a
|
|
- Muted (Zweck): #5a6470
|
|
- Code-Hintergrund: #1e2a3a
|
|
- Code-Text: #e6e6e6
|
|
- Syntax-Highlighting:
|
|
- Keywords (.k): #ff79c6 (pink)
|
|
- Variablen (.v): #ffb86c (orange)
|
|
- Strings (.s): #f1c40f (gelb)
|
|
- Funktionen (.f): #50fa7b (grün)
|
|
- Typen (.t): #8be9fd (cyan)
|
|
- Kommentare (.c): #6b8aae italic
|
|
- Label-Farbe in Code: #8be9fd (cyan)
|
|
|
|
INHALTLICHE PRINZIPIEN
|
|
- Titel: nur der Baustein-Name, kein Präfix, keine Variante
|
|
- Beschreibung: 1 Satz, was es macht (mechanisch, neutral)
|
|
- Zweck: 1 Satz, wofür man es nutzt (Anwendungsfall)
|
|
- Beide Sätze knapp wie möglich, jedes überflüssige Wort raus
|
|
- Pro Beispiel ein knappes Label oben (2-4 Wörter, uppercase)
|
|
|
|
LAYOUT-DETAILS
|
|
- Header und Body keine separaten Sektionen, alles in einer Card
|
|
- Titel zuerst, darunter direkt Beschreibung, darunter Zweck (mit margin-bottom)
|
|
- Margin-bottom Beschreibung: 6px (eng zum Zweck)
|
|
- Margin-bottom Zweck: 22px (Abstand zu Code)
|
|
- Margin-bottom Titel: 14px
|
|
- Code-Blöcke untereinander, gap 14px
|
|
- Code-Block padding: 14px 16px, border-radius 8px
|
|
|
|
CODE-BEISPIELE
|
|
- So viele wie nötig, so wenige wie möglich
|
|
- Untereinander gestapelt (grid-template-columns: 1fr)
|
|
- Jedes Beispiel zeigt eine sinnvolle Variante / Use-Case
|
|
- Sehr kurz: ideal 3-6 Zeilen, max 8 Zeilen
|
|
- Mit kurzem Label was die Variante zeigt
|
|
- Syntax-Highlighting durch span-Klassen (.k, .v, .s, etc.)
|
|
- Triviale Bausteine: 1-2 Beispiele
|
|
- Komplexere Bausteine: 4-6 Beispiele
|
|
- Anzahl ergibt sich aus dem Inhalt, nicht aus Vorgabe
|
|
|
|
VERMEIDEN
|
|
- Lange Erklärungstexte
|
|
- Mehrere Sätze für Beschreibung oder Zweck
|
|
- Performance-Tipps, Trade-Offs, Edge Cases
|
|
- Verwandte Bausteine, Varianten, Anti-Patterns
|
|
- Tabellen, Listen, Aufzählungen
|
|
- Icons, Emojis, Symbole
|
|
- Komplexe Code-Beispiele (über 8 Zeilen)
|
|
|
|
THEMENSPEZIFISCHE ANPASSUNGEN
|
|
- Bei anderen Sprachen: Syntax-Highlighting-Klassen anpassen
|
|
- Titel-Größe und Spacing bleiben gleich
|
|
- Card-Layout bleibt gleich
|
|
- Inhalte (Beschreibung, Zweck, Beispiele) sprachspezifisch
|
|
|
|
GENERIERUNG MIT FEEDBACK-LOOP
|
|
1. HTML schreiben
|
|
2. In Browser anzeigen (Playwright-Screenshot oder direkt)
|
|
3. Prüfen:
|
|
- Wirklich nur 4 Elemente (Titel, Beschreibung, Zweck, Beispiele)?
|
|
- Beschreibung und Zweck unter 15 Wörtern?
|
|
- Code-Beispiele unter 8 Zeilen?
|
|
- Labels über Code-Blöcken kurz und prägnant?
|
|
- Card kompakt, kein leerer Raum?
|
|
4. Wenn etwas zu viel: weglassen, nicht hinzufügen
|
|
5. Bei jeder Iteration prüfen: lässt sich noch was weglassen?
|
|
``` |