emanuelegori/forgejo-templates
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Template personalizzati per l'istanza Forgejo di git.emanuelegori.uno (home page e pagina 404)
7 commits 1 branch 0 tags 57 KiB
Find a file
Exact
Emanuele 96b2d9ea65 Aggiungi file LICENSE.md con testo completo CC BY-NC-SA 4.0
2025-12-30 06:52:17 +01:00
status Fix bottoni mobile: flexbox con gap 1rem, larghezza uniforme, responsive wrap 2025-12-29 23:44:57 +01:00
home.tmpl Fix responsive: box altezza uniforme (250px), flexbox per centratura, SVG Octicons, mobile-friendly 2025-12-29 23:32:25 +01:00
LICENSE.md Aggiungi file LICENSE.md con testo completo CC BY-NC-SA 4.0 2025-12-30 06:52:17 +01:00
README.md Aggiungi licenza CC BY-NC-SA 4.0: badge, sezione licenza e info autore 2025-12-30 06:51:52 +01:00

README.md

Template personalizzati Forgejo

Template personalizzati per l'istanza Forgejo di git.emanuelegori.uno.

Licenza Forgejo

Contenuto

  • home.tmpl - Home page personalizzata con 3 colonne informative
  • status/404.tmpl - Pagina 404 personalizzata con punto interrogativo

Caratteristiche Home Page

  • Titolo: "Git personale di emanuelegori"
  • Sottotitolo responsive con descrizione dei contenuti
  • 3 colonne con icone SVG Octicons e altezza uniforme (250px):
    • Self-hosted: Link all'articolo su come installare Forgejo
    • Open Source: Descrizione di Forgejo come alternativa a GitHub
    • Leggero e multipiattaforma: Gira su Raspberry Pi e cloud
  • Layout responsive: colonne stackable su mobile
  • Box con Flexbox per centratura perfetta del contenuto
  • Link al blog emanuelegori.uno
  • Mantiene navbar e footer originali Forgejo

Caratteristiche Pagina 404

  • Punto interrogativo grande e centrato (SVG Octicon, dimensione 80)
  • Scritta "404" in grande (6rem) con "Pagina non trovata" (1.8rem)
  • Bottoni con icone SVG per tornare alla home o esplorare repository
  • Link al blog per supporto
  • Design minimalista e responsive

Design Responsive

Entrambi i template sono ottimizzati per:

  • Desktop: Layout a 3 colonne, box con altezza uniforme
  • Tablet: Colonne che si adattano automaticamente
  • Mobile: Colonne impilate verticalmente, padding ottimizzato
  • Sottotitolo fluido: max-width 700px su desktop, 90% su mobile

Installazione

Prerequisiti

  • Forgejo installato con Docker Compose
  • Accesso al volume dei dati montato in /data
  • Variabile GITEA_CUSTOM=/data/gitea configurata

Path corretti

I template vanno posizionati in:

/percorso/al/volume/gitea-data/gitea/templates/
├── home.tmpl                    # Home personalizzata
└── status/
    └── 404.tmpl                 # Pagina 404

ATTENZIONE: NON usare la cartella custom/templates/ - il path corretto è direttamente templates/ sotto il CustomPath.

Comandi di installazione

# Vai nella directory di Forgejo (sostituisci con il tuo percorso)
cd /percorso/al/tuo/forgejo

# Crea la struttura delle directory
mkdir -p gitea-data/gitea/templates/status

# Scarica i template
wget https://git.emanuelegori.uno/emanuelegori/forgejo-templates/raw/branch/main/home.tmpl \
  -O gitea-data/gitea/templates/home.tmpl

wget https://git.emanuelegori.uno/emanuelegori/forgejo-templates/raw/branch/main/status/404.tmpl \
  -O gitea-data/gitea/templates/status/404.tmpl

# Riavvia Forgejo per applicare le modifiche
docker-compose restart forgejo

Verifica installazione

Dopo il restart:

Personalizzazione

Per modificare i template:

  1. Modifica i file localmente in gitea-data/gitea/templates/
  2. Riavvia Forgejo: docker-compose restart forgejo
  3. I template usano SVG Octicons per le icone (formato: {{svg "octicon-nome" dimensione}})

Personalizzare altezza box home page

Nel file home.tmpl, modifica min-height: 250px nei tre .segment:

<div class="ui center aligned basic segment" style="padding: 1rem; min-height: 250px; ...">

Valori suggeriti:

  • 200px - Box più bassi e compatti
  • 250px - Default (equilibrato)
  • 300px - Box più alti/quadrati

Variabili template disponibili

  • {{AppSubUrl}} - URL base dell'applicazione
  • {{AssetUrlPrefix}} - Percorso degli asset statici
  • {{ctx.Locale.Tr "chiave"}} - Traduzioni i18n
  • {{.IsSigned}} - Verifica se l'utente è autenticato
  • {{svg "octicon-nome" size}} - Inserisce icona SVG Octicon

Icone SVG Octicon disponibili

Alcune icone utili:

  • octicon-question - Punto interrogativo
  • octicon-home - Casa
  • octicon-archive - Archivio
  • octicon-server - Server
  • octicon-code - Codice
  • octicon-package - Pacchetto
  • octicon-link-external - Link esterno
  • octicon-alert - Triangolo attenzione

Lista completa Octicons

Note tecniche

  • I template usano il sistema di templating Go di Forgejo
  • home.tmpl sostituisce completamente la home predefinita
  • 404.tmpl si applica solo ai 404 generici (non a repository/utenti inesistenti)
  • RUN_MODE=prod richiede restart completo per caricare nuovi template
  • Forgejo usa SVG Octicons, non font icons Fomantic UI
  • Layout responsive con Flexbox per centratura perfetta
  • Grid Fomantic UI stackable per impilamento automatico su mobile

Risorse

Licenza

Questo progetto è rilasciato sotto licenza CC BY-NC-SA 4.0.

  • Uso personale: Gratuito
  • Modifiche: Consentite
  • Condivisione: Con stessa licenza
  • Uso commerciale: Richiede autorizzazione

Per uso commerciale contatta: emanuelegori.uno

Vedi LICENSE.md per dettagli completi.

Autore

Emanuele Gori