Sito web statico della XI Conferenza Italiana Studenti di Fisica, realizzato con Astro + Svelte, stili con Tailwind CSS e daisyUI. La compilazione del modulo contatti è gestita tramite Google Apps Script. Traduzioni gestite tramite Fink (inlang).
git clone git@github.com:ai-sf/cisf27.git
cd cisf27
pnpm install- Google Apps Script - segui la guida per creare il Form e pubblicare la Web App.
- Configura ambiente - copia
.env.examplein.enve impostaPUBLIC_GOOGLE_SCRIPT_URL(variabili d'ambiente). - Build -
pnpm run build. L'output statico è indist/. - Deploy - carica
dist/su Cloudflare Pages, Netlify, o qualsiasi hosting statico. ImpostaPUBLIC_GOOGLE_SCRIPT_URLcome variabile d'ambiente sulla piattaforma.
| Strato | Tecnologia |
|---|---|
| Framework | Astro 6 + Svelte 5 |
| Stili | Tailwind CSS 4 + daisyUI 5 |
| Icone | Lucide |
| Font | Nunito, Playfair Display (via Fontsource) |
| Traduzioni / i18n | Fink / inlang (file JSON in src/data/locales/) |
| CMS | PagesCMS / file JSON |
| Backend contatti | Google Apps Script |
| Package manager | pnpm 11 |
| Linguaggio | TypeScript 6 |
| Linting / formatting | ESLint 10 + Prettier 3 |
/
├── .env # Variabili d'ambiente (gitignorato)
├── .env.example # Template delle variabili d'ambiente
├── .pages.yml # Schema CMS PagesCMS (punta a src/data/cms/)
├── project.inlang/ # Configurazione inlang / Fink
├── astro.config.mjs # Configurazione Astro (routing i18n it/en)
├── svelte.config.js # Configurazione Svelte
├── tsconfig.json # Configurazione TypeScript
├── eslint.config.mjs # ESLint flat config
├── prettier.config.mjs # Prettier config
├── pnpm-workspace.yaml # Pnpm workspace
├── package.json
│
├── docs/ # Documentazione di dettaglio
│ ├── fink-inlang-setup.md # Guida architettura e flusso traduzioni Fink
│ └── google-apps-script.md # Guida completa setup, deploy e debug Apps Script
│
├── google-apps-script/ # Backend contatti (Google Apps Script)
│ ├── .clasp.json # Config clasp (scriptId)
│ ├── appsscript.json # Manifest GAS
│ └── Code.js # Web App: doPost → Invio email con CC + Google Form
│
├── public/
│ ├── favicon.ico
│ └── robots.txt
│
├── scripts/
│ ├── check-i18n.js # Validazione parità chiavi e sintassi JSON i18n
│ └── sync-subcatalogs.js # Generazione automatica locales/it da CMS e update inlang
│
├── src/
│ ├── assets/
│ │ └── images/ # Immagini caricate via CMS
│ ├── components/ # Componenti Astro / Svelte
│ ├── config/
│ │ └── languages.json # Configurazione lingue attive
│ ├── data/
│ │ ├── cms/ # Dati CMS sorgente (modificabili via PagesCMS)
│ │ │ ├── structures/
│ │ │ ├── structure-categories/
│ │ │ ├── partner-categories/
│ │ │ └── people-roles/
│ │ ├── pageLinks.ts
│ │ ├── partners.ts
│ │ ├── people.ts
│ │ ├── stats.ts
│ │ └── structures.ts
│ │ ├── locales/ # Traduzioni e cataloghi per Fink # Traduzioni e cataloghi per Fink
│ │ ├── it/ # Generato automaticamente da sync-subcatalogs.js (baseLocale)
│ │ └── en/ # Traduzioni in lingua inglese (gestite da Fink)
│ │ ├── stats.ts
│ │ └── structures.ts
│ ├── layouts/ # Layout Astro
│ ├── pages/ # Route Astro (italiano e sub-route en/)
│ ├── styles/
│ ├── types/
│ └── utils/
│
├── .github/workflows/
│ ├── ci.yml # CI: validazione i18n, formato + lint + typecheck
│ └── deploy.yml # Deployment automatico
│
└── dist/ # Output di build (gitignorato)
-
Node.js ≥ 22.12.0
-
pnpm 11 - installa con
npm i -g pnpmo abilita tramite Corepack:corepack enable corepack prepare pnpm@11 --activate
Tutti i comandi vanno eseguiti dalla root del progetto.
| Comando | Azione |
|---|---|
pnpm install |
Installa le dipendenze del progetto |
pnpm run dev |
Avvia il server di sviluppo su localhost:4321 |
pnpm run build |
Compila il sito statico di produzione in ./dist/ |
pnpm run preview |
Anteprima locale della build di produzione |
pnpm run astro |
Esegue un comando Astro CLI (astro add, …) |
pnpm run sync:subcatalogs |
Sincronizza i file delle lingue target da it/ e aggiorna project.inlang |
pnpm run check:i18n |
Controlla la validità JSON e la parità delle chiavi i18n |
pnpm run inlang:check |
Valida le traduzioni con inlang CLI (sintassi, markup, variabili) |
pnpm run typecheck |
Controlla i tipi con astro check e svelte-check |
pnpm run check |
check:i18n + flint + typecheck (da eseguire prima di ogni commit) |
pnpm run lint |
Controlla il codice con ESLint |
pnpm run lint:fix |
Corregge automaticamente i problemi ESLint |
pnpm run format |
Controlla la formattazione con Prettier |
pnpm run format:write |
Formatta tutti i file con Prettier |
pnpm run flint |
format:write + lint:fix in sequenza |
I testi dell'interfaccia e i contenuti della conferenza sono organizzati tra sorgente CMS e cataloghi di traduzione:
src/data/cms/: lingua sorgente e fonte di verità autorevole, modificata direttamente tramite PagesCMS (senza cartelle per-lingua, con array JSON completi, ID e metadati).src/data/locales/it/: catalogo di riferimento per Fink, generato automaticamente dallo script di sincronizzazione a partire dasrc/data/cms/(array convertiti in oggetti indicizzati per compatibilità totale con plugin-json).src/data/locales/en/: traduzioni in lingua inglese, tradotte collaborativamente su Fink.
La traduzione visiva collaborativa è gestita tramite Fink (https://fink.inlang.com/github.com/ai-sf/cisf27).
Per la guida completa sull'architettura, sincronizzazione automatica dei sottocataloghi e aggiunta di nuove lingue, consulta docs/fink-inlang-setup.md.
Il progetto necessita di una sola variabile d'ambiente, esposta al client:
PUBLIC_GOOGLE_SCRIPT_URL=https://script.google.com/macros/s/YOUR_DEPLOYMENT_ID/execSetup:
cp .env.example .envModifica .env con l'URL del tuo deployment Google Apps Script (vedi sezione successiva).
.envè gitignorato. In produzione imposta la variabile d'ambiente nella dashboard della piattaforma di hosting.
Il backend del form contatti risiede in google-apps-script/ e gestisce l'invio immediato di un'email formattata tramite MailApp.sendEmail all'indirizzo istituzionale cisf27@ai-sf.it, con impostazione automatica del replyTo del mittente e CC dinamico in base all'argomento selezionato:
- Sponsorizzazione ➔ CC:
diego.ficarra@ai-sf.it,mariarosaria.sivo@ai-sf.it - Logistica ➔ CC:
tomislav.vojvodic@ai-sf.it - Programma Scientifico ➔ CC:
marta.grenno@ai-sf.it,chiara.luppino@ai-sf.it,ludovica.rainero@ai-sf.it - Iscrizione ➔ CC:
francesco.isgrò@ai-sf.it,alessandro.dagostino@ai-sf.it - Altro / Fallback ➔ CC:
francesco.isgrò@ai-sf.it,alessandro.dagostino@ai-sf.it
Se configurata la proprietà FORM_ID, i messaggi vengono inoltre archiviati come risposte in un Google Form di riserva.
📖 Guida Completa di Setup, Deploy e Risoluzione Errori:
Consultadocs/google-apps-script.mdper istruzioni dettagliate su autorizzazioni OAuth, deploy come Web App, test diagnostici e gestione conclasp.
I contenuti editoriali sono gestiti tramite PagesCMS, configurato in .pages.yml.
- I dati risiedono direttamente in
src/data/cms/(file JSON editabili sia tramite interfaccia che a mano). - Ogni file o cartella JSON corrisponde a una collezione o catalogo:
- Cataloghi principali di pagina:
home.json,about.json,program.json,contacts.json,structures.json, … - Sottocataloghi modulari:
structures/(alloggi e sedi),partner-categories/,people-roles/,structure-categories/.
- Cataloghi principali di pagina:
- Le immagini caricate tramite CMS vengono salvate in
src/assets/images/e ottimizzate in fase di build. - In PagesCMS la modifica agisce direttamente sui contenuti in
src/data/cms/. Lo scriptpnpm run sync:subcatalogsgenera la versione per Fink insrc/data/locales/it/.
# 1. Clona il repository
git clone git@github.com:ai-sf/cisf27.git
cd cisf27
# 2. Installa le dipendenze
pnpm install
# 3. Prepara l'ambiente
cp .env.example .env
# 4. Avvia il dev server
pnpm run dev
# 5. Sviluppa - tutte le modifiche sono visibili in tempo reale su localhost:4321
# 6. Prima di ogni commit, esegui i controlli completi di qualità
pnpm run check# Build statica per produzione
pnpm run buildL'output compilato è disponibile nella cartella dist/. Può essere ospitato su qualsiasi provider statico:
- Cloudflare Pages → collega il repository GitHub, build command:
pnpm run build, output directory:dist - Netlify → build command:
pnpm run build, publish directory:dist - GitHub Pages → distribuzione automatica della cartella
dist/tramite GitHub Actions
Assicurati di configurare la variabile d'ambiente PUBLIC_GOOGLE_SCRIPT_URL nelle impostazioni della piattaforma di hosting.