zomas
f5c763be7b
- Logo/favicon ridisegnati come theta maiuscola: cerchio (anello) con 'H' centrata, clearance verificata (non tocca l'anello); ring ispessito per la favicon; centratura ottica verificata. - Rimosso il badge 'Self-hosted Git' dal hero della homepage (era esteticamente di troppo) - CSS e markup. - Aggiornati generate_theta.py, README, home.tmpl; caricati sul VPS in staging (md5 locali == remoti); tarball ricostruito. - Salvataggio iniziale dell'intero admin pack in git.
96 lines
3.6 KiB
Markdown
96 lines
3.6 KiB
Markdown
# 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.
|