# Marken-Dateien

Alles hier stammt aus einem einzigen Original: dem D4RKST3R-Logo in 2048×2048
mit Transparenz (Katzenkopf über dem Schriftzug-Banner).

## Was hier liegt

| Datei | Was | Wofür |
|---|---|---|
| `logo.png` | **das Original**, 2048×2048 mit Transparenz | Quelle für alles Weitere |
| `lockup.png` | volles Logo, auf den Inhalt beschnitten | Kopfzeilen, Discord-Banner, OG-Bilder |
| `mark.png` | nur der Katzenkopf, 1024×1024 | alles Quadratische — Favicon, Avatar |
| `build.py` | erzeugt beide plus die abgeleiteten Icons | Neubau nach Logo-Änderung |
| `studie-kopf-2025-06.png` | frühere Kopf-Studie, 636×636 | nirgends in Benutzung, liegt als Herkunft |

**Achtung beim Neubau:** `build.py` liest das Original noch über einen festen
Pfad ausserhalb des Repos (`QUELLE = A:/Users/DAR/logo.png`). Seit das Original
hier neben der Datei liegt, sind das zwei Kopien, die auseinanderlaufen können —
wer das Logo ändert, muss beide anfassen oder `QUELLE` auf `logo.png` umstellen.

## Warum zwei Fassungen

Das volle Lockup ist bei 16 oder 32 Pixeln unbrauchbar — der Schriftzug wird zu
einem orangen Balken. Für Favicon, Avatar und Navbar-Logo wird deshalb nur der
Kopf verwendet, mit Ohrenspitzen und etwas Schulter. Der Zuschnitt steht in
`build.py` als `KOPF` und wurde von Hand gegen drei Varianten geprüft: enger
schneidet die Ohren ab, weiter fängt schon den Banner ein.

## Warum SVG mit eingebettetem PNG

Gitea will `logo.svg` und `favicon.svg` — echte SVG-Dateien. Das Original ist
aber eine Rastergrafik mit Verläufen und Schattierung; nachvektorisieren würde
sie matschig machen. Deshalb wird das PNG in eine SVG-Hülle gelegt
(`<svg><image href="data:image/png;base64,…"/></svg>`). Das ist gültiges SVG,
Gitea nimmt es an, und es sieht aus wie das Original.

Die eingebettete Auflösung ist bewusst klein gehalten: das Navbar-Logo hängt an
jedem Seitenaufruf, 192 px reichen für eine Darstellung mit rund 30 px.

## Wohin die erzeugten Dateien gehen

`build.py` schreibt direkt an beide Ziele:

```
A:/eco/Gitea/data/gitea/public/assets/img/
    logo.svg              Navbar + App-Icon
    favicon.svg           Browser-Tab
    favicon.png           Rückfallebene, die Gitea als „alternate icon" setzt
    apple-touch-icon.png  iOS-Lesezeichen (180 px, deckend)
    avatar_default.png    Standardavatar für Konten ohne Bild (512 px)

frontend/public/
    favicon.svg
    apple-touch-icon.png
    og-default.png        Vorschaubild geteilter Links, 1200×630

src/bot/assets/
    mark-card.png         Wasserzeichen der Willkommens-Karte
```

`src/bot/assets/` statt `docs/` ist Absicht: das Dockerfile kopiert nur `src/`
und `frontend/dist/`, alles andere existiert im Container nicht.

Die Icons auf dunklem Grund sind **deckend** (`#0a0a0a`, abgerundet) — iOS legt
hinter transparente Lesezeichen sonst Schwarz oder Weiß, je nach Laune, und die
Katze ist selbst fast schwarz.

## Neu bauen

```bash
python docs/brand/build.py
```

Danach für Gitea `docker restart gitea` — die Dateien unter `custom/` werden
beim Start eingelesen. Fürs Frontend reicht der normale Build.