- testi: «lo Studio» uniforme, «Centro autorizzato CAF», ripetizioni tolte nei servizi e in «Lo studio», valori senza superlativi, meta corrette, testo della mappa di §10.2, numeri e indirizzi con spazi non separabili - visuale: breadcrumb, anello della banda CTA, card dei professionisti, pager e sidebar dei servizi su mobile, pagine legali a colonna singola, pulsante e-mail su una riga, card sedi allineate - dati: fatti della sede di Asti da studio.ts/testi.ts, sede.telefono - 404 e conferma senza canonical; avviso mappa senza JavaScript - controlli: CSP per direttive (endpoint), anno da SOURCE_DATE_EPOCH, URL del sito controllati sulla build locale, import file:// e tar da stdin per Windows, .gitattributes, porta libera corretta - modulo: pattern del telefono valido, avviso visibile, Esc sul sottomenu aperto al passaggio del mouse; contact.php con -f, senza mbstring obbligatorio, fuso Europe/Rome - release: note --shell-safe, ripiego REST automatico, RELEASE_TOKEN; deploy di esempio senza esclusione di contact.php; nginx /privacy/ - DECISIONS D-040–D-044, TODO C4 e riferimenti di riga aggiornati Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_016zJ9ZWGKvoKoxYwbmnRKdJ
7.5 KiB
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.
email: 'info@studiograssoezio.it',
- Telefono: ogni numero ha due forme:
display(come appare, con spazi) ede164(per la chiamata, solo+e cifre):{ display: '+39 0141 951382', e164: '+390141951382' }, - Orari: nell'oggetto
orarile fasce sono in formato 24 ore ('09:00'); i testigiorni,giorniEsteso,giorniBreveenotaAstisono 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 dinull, es.denominazione: 'Studio Tributario Grasso S.r.l.',. L'elenco dei dati da completare è inTODO-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:
---
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,ordineeanchorLegacy(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:
{
"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 distudio.ts: non cancellarli e non inventarne di nuovi (la verifica si fermerebbe). Elenco completo insrc/lib/legal.ts; - blocchi condizionali, es.
<!-- se:modulo -->…<!-- /se:modulo -->: 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, separate 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
- Verifica verde (segno verde nella scheda Actions, oppure
npm run verifyin locale). - 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.
- Caricare lo zip sull'hosting come descritto in
docs/DEPLOY.md(o automaticamente, se è stato attivato il deploy automatico).