@@ -7,12 +7,15 @@ Il sito genera automaticamente immagini di anteprima personalizzate per ogni ini
77## Come Funziona
88
99### 1. Generazione Automatica
10+
1011- Durante il build, il sistema scarica tutte le iniziative dall'API
1112- Per ogni iniziativa viene generata un'immagine PNG di 1200x630px
1213- Le immagini vengono salvate in ` public/og-images/ `
1314
1415### 2. Template delle Immagini
16+
1517Ogni immagine include:
18+
1619- ** Sfondo gradiente** con colori personalizzati
1720- ** Titolo dell'iniziativa** (max 3 righe)
1821- ** Badge della categoria** con colore specifico per tipo
@@ -21,6 +24,7 @@ Ogni immagine include:
2124- ** Elementi decorativi** per un design accattivante
2225
2326### 3. Colori per Categoria
27+
2428``` typescript
2529AMBIENTE : #10b981 (verde )
2630SALUTE : #ef4444 (rosso )
@@ -33,9 +37,11 @@ TRASPORTI: #84cc16 (lime)
3337```
3438
3539### 4. Meta Tag Open Graph
40+
3641Ogni pagina di iniziativa include:
42+
3743``` html
38- <meta property =" og:image" content =" https://aborruso .github.io/referendum_astro /og-images/og-[ID].png" />
44+ <meta property =" og:image" content =" https://ondata .github.io/referendum_iniziative_popolari /og-images/og-[ID].png" />
3945<meta property =" og:image:width" content =" 1200" />
4046<meta property =" og:image:height" content =" 630" />
4147<meta name =" twitter:card" content =" summary_large_image" />
@@ -44,15 +50,18 @@ Ogni pagina di iniziativa include:
4450## File Coinvolti
4551
4652### Generazione
53+
4754- ` src/lib/og-image-generator.ts ` - Libreria principale per creare le immagini
4855- ` scripts/generate-og-images.js ` - Script che genera tutte le immagini
4956- ` package.json ` - Include il comando ` npm run generate-og-images `
5057
5158### Layout
59+
5260- ` src/layouts/Layout.astro ` - Aggiunge i meta tag Open Graph
5361- ` src/pages/initiative/[id].astro ` - Usa l'immagine specifica per iniziativa
5462
5563### Deploy
64+
5665- ` .github/workflows/deploy.yml ` - Genera le immagini durante il build su GitHub Actions
5766
5867## Comandi Utili
@@ -71,28 +80,34 @@ npm run dev
7180## Personalizzazione
7281
7382### Modificare i Colori
83+
7484Modifica la funzione ` getCategoryColor() ` in ` src/lib/og-image-generator.ts `
7585
7686### Cambiare il Template
87+
7788Modifica la variabile ` svgTemplate ` nella funzione ` generateOGImage() `
7889
7990### Aggiungere Nuovi Elementi
91+
8092- Logo/immagini: aggiungile come elementi SVG nel template
8193- Testi aggiuntivi: modifica la struttura SVG
8294- Effetti grafici: usa pattern SVG o gradienti
8395
8496## Risoluzione Problemi
8597
8698### Le immagini non vengono generate
99+
871001 . Controlla che Sharp sia installato: ` npm list sharp `
881012 . Verifica i permessi di scrittura in ` public/og-images/ `
891023 . Controlla i log del comando: ` npm run generate-og-images `
90103
91104### URL delle immagini non corretti
105+
92106- Verifica la configurazione ` site ` e ` base ` in ` astro.config.mjs `
93107- Controlla la funzione ` ogImageUrl ` in ` Layout.astro `
94108
95109### Immagini non visibili sui social
110+
96111- Testa con il [ Facebook Sharing Debugger] ( https://developers.facebook.com/tools/debug/ )
97112- Usa il [ Twitter Card Validator] ( https://cards-dev.twitter.com/validator )
98113- Assicurati che le immagini siano pubblicamente accessibili
0 commit comments