Le run della CI restavano «in attesa» perché l'unico runner dell'istanza («Ferrari») non si è mai collegato: il runner resta da configurare. La revisione completa del codice ha trovato anche difetti che avrebbero fatto fallire la CI con il runner online, oltre ad altri problemi del sito, dei controlli e della documentazione. CI e rilascio: - continue-on-error sullo step dei link esterni: Forgejo lo ignora sul job, e un sito esterno irraggiungibile avrebbe reso rossa la CI; - artifact con i file nascosti (report Lighthouse e .htaccess non venivano mai caricati); - token personale RELEASE_TOKEN: FORGEJO_TOKEN è riservato ed è sempre il token automatico; - dominio in un solo punto (site.config.mjs) e variabile del repository SITE_URL; - ripiego REST: release in bozza, file, poi pubblicazione; tag verificato sul server; sostituzione dei file senza mai lasciarli mancanti; - tar.gz identico su Windows, macOS e Linux (byte del sistema operativo nell'header gzip). Sito: CSS compatibile con Safari/iOS 15 (media query classiche, backdrop-filter), anello di focus con contrasto di almeno 3:1, bersagli touch di 44 px dove servono, intestazione desktop senza voci o logo a capo, HTML valido in /servizi/, colore delle chip, stampa senza mappe, giorni di apertura, ricerca e titolo delle mappe e numero breve ricavati dai dati. Modulo di contatto e contact.php: stesse regole nel browser e sul server (spazi, e-mail, a capo, lunghezze), tempo minimo misurato con un solo orologio (ts_invio), corpo in quoted-printable e oggetto RFC 2047, funzionamento con PHP a 32 bit, costante MODALITA_PREDEFINITA per attivarlo. Controlli e test: valori letti dai dati del sito, i sei servizi del brief con le ancore, «commercialista» anche in meta, attributi e dati strutturati, .htaccess su righe attive, HSTS attivabile con una scelta esplicita, contrasto del focus misurato nei test. Esempi di pubblicazione: nginx con gli header di sicurezza in un solo punto (HSTS compreso), deploy automatico che parte alla pubblicazione e sincronizza solo una cartella confermata, procedura nginx che toglie i file delle versioni precedenti. Debug: .vscode/launch.json e tasks.json, F5 avvia il server Astro e apre il browser con il debugger collegato. Documentazione aggiornata (README, DEPLOY, CONTENUTI, CONFORMITA, TODO-STUDIO, CHANGELOG) e decisioni D-045…D-055. Verificato: npm run verify su Windows e nel container della CI (Playwright 1.56.1, root); job dei link esterni in node:24; contact.php con PHP 7.4 e 8.3, a 64 e 32 bit; nginx in Docker; release-upload.sh e deploy di esempio contro API e shell simulate. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
8.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 (un file per ogni pagina di servizio) | 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. Se cambiano i giorni di apertura, aggiornare insieme ai tre testi anchegiorniSettimana, l'elenco in inglese usato dai motori di ricerca (es.['Monday', 'Tuesday', 'Wednesday', 'Thursday']per «dal lunedì al giovedì»). - Indirizzo di una sede: si modifica solo in
indirizzo; la ricerca per le indicazioni stradali, i link a Google Maps e OpenStreetMap e il titolo della mappa si aggiornano da soli. Vanno invece cambiati a manomappa.embedUrl(su Google Maps: Condividi → Incorpora una mappa, poi copiare l'indirizzo doposrc=") e la descrizione della pagina «Dove siamo» insrc/data/pagine.ts(doveSiamoPagina), che cita le vie. - 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), con le sole eccezioni indicate sopra per l'indirizzo. I controlli automatici leggono gli stessi dati: un orario o un recapito aggiornato non fa fallire la verifica.
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, diverso da quelli degli altri servizi); compare da solo in menu, home, pagina Servizi e footer. I sei servizi originali non vanno eliminati: la verifica controlla che ci siano tutti.
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), anche nelle descrizioni per Google e nei testi alternativi delle immagini; 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).