# Gitea theme pack — git.zomas.net

Homepage moderna + favicon/logo personalizzati per l'istanza Gitea.

## Contenuto

```
custom/
  templates/home.tmpl                  # homepage pubblica ridisegnata
  public/assets/img/logo.svg           # logo (navbar + hero)
  public/assets/img/logo.png
  public/assets/img/favicon.svg        # icona tab browser (SVG)
  public/assets/img/favicon.png        # favicon fallback (PNG)
  public/assets/img/apple-touch-icon.png
install_gitea_theme.sh                 # installer — da eseguire come ROOT sul VPS
rollback_gitea_theme.sh                # ripristino stato iniziale — da eseguire come ROOT
gitea_theme.sh                         # script UNICO: install o rollback (consigliato)
generate_theta.py                      # rigenera logo/favicon con theta greca (opzionale, serve PIL)
```

La homepage pubblica (la landing page che si vede su git.zomas.net
senza login) è ora un hero con gradiente, titolo, tagline e 4
feature card. Usa solo CSS inline + variabili tematiche di Gitea, quindi
rispetta automaticamente tema chiaro/scuro.

Il logo è una THETA MAIUSCOLA (Θ): un cerchio (anello) con una "H"
centrata. La H non tocca i bordi dell'anello (clearance verificata),
in bianco su quadrato arrotondato con gradiente viola→azzurro.
Niente badge "Self-hosted Git" sopra il logo (era esteticamente di
troppo) — il hero parte direttamente dal logo.

## Requisiti / limitazione

Installare questi file richiede **accesso root** (o appartenenza al
gruppo `gitea`) sul VPS: la cartella `/var/lib/gitea/custom` non è
scrivibile dall'utente SSH `deb_zomas_connection`. L'installer va quindi
lanciato da chi ha root.

I file sono già stati caricati sul VPS in staging (dall'utente
`deb_zomas_connection`) in `/var/tmp/gitea-theme/` — pronto per essere
installato da root.

## Applicazione (root sul VPS) — script UNICO

I file sono già sul VPS. Da root, uno script solo gestisce tutto:

```bash
cd /var/tmp/gitea-theme/gitea-theme-pack

bash gitea_theme.sh install     # applica homepage moderna + favicon
bash gitea_theme.sh rollback    # torna allo stato iniziale (se non piace)
```

Lo script `gitea_theme.sh` è l'unico che serve:
- `install` salva il backup delle eventuali personalizzazioni in
  `/var/lib/gitea/custom/.backup-*`, copia i file, imposta i permessi
  `gitea:gitea`, scrive lo stato in `$CUSTOM_DIR/.gitea-theme-state`,
  riavvia Gitea e verifica gli asset.
- `rollback` rimuove homepage+favicon custom, ripristina la precedente
  personalizzazione dal backup (se esiste), riavvia Gitea.

(Permangono anche `install_gitea_theme.sh` e `rollback_gitea_theme.sh`
come equivalenti separati, per chi preferisce un comando per azione.)

3. Sul browser apri https://git.zomas.net premendo **Ctrl+Shift+R**
   (hard reload) per bypassare la cache.

## Ripristino

Se la modifica non piace, da root sul VPS:

```bash
cd /var/tmp/gitea-theme/gitea-theme-pack
bash gitea_theme.sh rollback
```

Lo script rimuove homepage + favicon custom, ripristina l'eventuale
personalizzazione precedente dal backup (se esiste), riavvia Gitea e
verifica. In alternativa il ripristino manuale è:

```bash
rm -rf /var/lib/gitea/custom/templates/home.tmpl /var/lib/gitea/custom/public/assets/img
systemctl restart gitea
```

La vecchia homepage è comunque salvata anche su questo PC in
`/home/zomas/vps-admin/homepage-backup/homepage_original_20260901-152245.html`.

## Note

- Gitea 1.27.3. Homepage di riferimento: stock `templates/home.tmpl`.
- Le icone octicon usate (`git-branch`, `shield-check`, `telescope`,
  `sign-in`, `repo`, `code`, `rocket`) e le chiavi locale
  (`dashboard`, `explore_title`, `sign_in`, `home_title`) sono verificate
  esistenti nel sorgente Gitea 1.27.3.