# Aggiornare i contenuti del sito Guida per lo Studio: dove si trovano i testi e i dati e come modificarli. Non serve conoscere la programmazione, ma bisogna rispettare la forma dei file (virgolette, virgole, trattini all'inizio delle righe degli elenchi). ## Come si modifica un file **Dal browser (consigliato):** aprire il repository su Forgejo, entrare nel file, premere l'icona a forma di matita («Modifica file»), fare la modifica, scrivere in basso una breve descrizione (es. `docs: aggiorna orari di agosto`) e confermare con **Commit**. La verifica automatica (CI) parte da sola: dopo qualche minuto, nella scheda **Actions**, un segno verde indica che è tutto a posto; una croce rossa indica un errore, con la spiegazione nel dettaglio dell'esecuzione. **Dal computer:** modificare il file con un editor di testo (es. Visual Studio Code), poi `npm run verify` e commit. Le modifiche diventano visibili sul sito **solo dopo una nuova release** e il suo caricamento sull'hosting (vedi in fondo). ## Dove si trovano i contenuti | Cosa | File | | -------------------------------------------------------------------------------- | ------------------------------------------------------------ | | Recapiti, indirizzi, orari, P.IVA, PEC | `src/data/studio.ts` (parte iniziale, oggetto `studio`) | | Professionisti e qualifiche | `src/data/studio.ts` (`professionisti`) | | Abilitazioni e iscrizioni (i 9 riquadri) | `src/data/studio.ts` (`abilitazioni`) | | Valori, partner, collaborazioni | `src/data/studio.ts` (`valori`, `partner`, `collaborazioni`) | | Servizi (testo delle 6 pagine) | `src/content/servizi/*.md` | | Link utili | `src/content/link-utili.json` | | Privacy policy, Cookie policy, Note legali, Accessibilità | `src/content/legali/*.md` | | Testi delle pagine (home, Lo studio, Contatti…), titoli e descrizioni per Google | `src/data/pagine.ts` | | Banda «Sei interessato…», testi della mappa e del modulo | `src/data/testi.ts` | | Voci del menu | `src/data/navigazione.ts` | ## Recapiti e orari (`src/data/studio.ts`) I valori sono tra apici: si modifica solo il testo tra gli apici, lasciando apici e virgola finale. ```ts email: 'info@studiograssoezio.it', ``` - **Telefono:** ogni numero ha due forme: `display` (come appare, con spazi) ed `e164` (per la chiamata, solo `+` e cifre): `{ display: '+39 0141 951382', e164: '+390141951382' },` - **Orari:** nell'oggetto `orari` le fasce sono in formato 24 ore (`'09:00'`); i testi `giorni`, `giorniEsteso`, `giorniBreve` e `notaAsti` sono quelli mostrati. - **Dati mancanti:** i campi con `null` (es. `denominazione: null`) non compaiono sul sito finché non vengono compilati: scrivere il valore tra apici al posto di `null`, es. `denominazione: 'Studio Tributario Grasso S.r.l.',`. L'elenco dei dati da completare è in `TODO-STUDIO.md`. - Per l'apostrofo nei testi visibili usare `’` (es. `Montegrosso d’Asti`). Un dato modificato qui si aggiorna automaticamente in **tutte** le pagine (intestazione, footer, contatti, pagine legali, dati per i motori di ricerca). ## Servizi (`src/content/servizi/*.md`) Ogni servizio è un file con un'intestazione tra due righe `---` e il testo sotto: ```md --- titolo: 'Contabilità fiscale' slug: contabilita-fiscale # indirizzo: /servizi/contabilita-fiscale/ (non cambiarlo) ordine: 2 # posizione negli elenchi icona: calculator # nome di un'icona da https://lucide.dev/icons/ anchorLegacy: contabilita-fiscale-2 # non modificare (collegamenti del vecchio sito) sommario: 'Testo breve della card (massimo 160 caratteri).' sottotitolo: 'Frase sotto il titolo della pagina.' descrizioneSeo: 'Descrizione per Google, tra 120 e 155 caratteri.' --- Paragrafo introduttivo. ## Titolo di un gruppo - Prima voce della lista (diventa una riga con la spunta) - Seconda voce ``` - `## ` all'inizio della riga crea un titolo di gruppo; `- ` crea una voce dell'elenco. - Un link: `[testo del link](/servizi/contenzioso-tributario/)`. - Se un campo non rispetta le regole (es. descrizione troppo lunga), la verifica si ferma e indica file e campo da correggere. - **Nuovo servizio:** copiare un file esistente, cambiare nome del file, `slug`, `ordine` e `anchorLegacy` (un nome nuovo qualsiasi); compare da solo in menu, home, pagina Servizi e footer. ## Link utili (`src/content/link-utili.json`) Ogni link è un blocco tra parentesi graffe, separato dal successivo da una virgola: ```json { "id": "inps", "ordine": 5, "nome": "INPS", "descrizione": "Istituto Nazionale della Previdenza Sociale: pensioni, prestazioni e servizi online.", "url": "https://www.inps.it" } ``` Gli indirizzi devono iniziare con `https://`. Prima di una release: `npm run test:links -- --external` controlla che i siti esterni rispondano. ## Pagine legali (`src/content/legali/*.md`) Sono scritte come i servizi (Markdown). In più contengono: - **segnaposto** tra doppie graffe, es. `{{email}}`, `{{bloccoTitolare}}`, sostituiti automaticamente con i dati di `studio.ts`: non cancellarli e non inventarne di nuovi (la verifica si fermerebbe). Elenco completo in `src/lib/legal.ts`; - **blocchi condizionali**, es. `` … ``: il testo compare solo quando la condizione è vera (qui: modulo di contatto attivo). Dopo ogni modifica sostanziale aggiornare la data `aggiornato:` nell'intestazione (formato `AAAA-MM-GG`) e far rivedere il testo al consulente privacy. ## Testi delle pagine (`src/data/pagine.ts`) Contiene, pagina per pagina, titoli, sottotitoli, paragrafi e i **meta** per i motori di ricerca: `titolo` (breve: «— Studio Grasso…» viene aggiunto da solo) e `descrizione` (tra 120 e 155 caratteri, con località e servizi). I paragrafi sono elenchi di frasi tra apici separati da virgole. **Regole sui contenuti** (verificate in automatico dove possibile): - solo fatti veri e verificabili: niente numeri, anni di esperienza, clienti, recensioni o superlativi; - titoli professionali esatti: «commercialista» solo per la Dott.ssa Giulia Grasso (ODCEC di Asti); lo Studio è «Studio Grasso — Studio Tributario e Societario»; - niente tariffe né promesse di risultato o di tempi di risposta (è ammesso «ti rispondiamo nel più breve tempo possibile»); - dare del «tu» nelle frasi rivolte al visitatore («Richiedi un preventivo»). ## Immagini Foto e loghi autorizzati vanno consegnati a chi gestisce il sito: vedi `public/images/README.md`. ## Pubblicare le modifiche 1. Verifica verde (segno verde nella scheda **Actions**, oppure `npm run verify` in locale). 2. Chiedere a chi gestisce il sito di creare una **nuova release** (aggiornamento della versione e del CHANGELOG, poi tag: vedi README, «Fare una release»). La release produce lo zip da caricare. 3. Caricare lo zip sull'hosting come descritto in `docs/DEPLOY.md` (o automaticamente, se è stato attivato il deploy automatico).