Il progetto vive in modo definitivo su Gitea: i workflow passano da .forgejo/ a .gitea/workflows/ e la documentazione non nomina più la piattaforma precedente. - ci.yml: i controlli di npm run verify sono passi separati (si vede subito quale è fallito) e alla fine la CI crea lo zip di rilascio e ne verifica il contenuto, così un errore di pacchetto emerge prima del tag. Runner ubuntu-latest, azioni da github.com con URL completo, upload-artifact@v3 (la v4 non funziona su Gitea). - release.yml: a ogni tag vX.Y.Z verifica tutto, crea lo zip e lo pubblica nella Release con scripts/release-upload.sh e l'API di Gitea, senza action esterne di release. - La release contiene un solo file, sito-studio-grasso-vX.Y.Z.zip (contenuto di dist/ alla radice, .htaccess compreso): tolti tar.gz, SHA256SUMS.txt e BUILD-INFO.txt da package.mjs, check-package.mjs e dalla documentazione. - release-upload.sh: variabili GITEA_*, si ferma su errori diversi da 404 invece di provare a creare la release, rifiuta una cartella vuota; provato su una finta API Gitea. - deploy/gitea-deploy.yml.example convertito per Gitea (resta disattivato). - Versione 1.0.1 pronta (package.json, CHANGELOG, D-056 e D-057 in DECISIONS.md); il tag v1.0.1 non è stato creato. Verifica: npm run verify completo (lint, formato, tipi, build, HTML, link, e2e 39, a11y 51, conformità 1455, Lighthouse) e npm run package eseguiti in una copia fuori da .claude/. I workflow non sono ancora stati eseguiti su un runner Gitea. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
9.0 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 Gitea, 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»). Al termine del workflow la release compare nella sezione Release del repository, con un solo file allegato: lo zip
sito-studio-grasso-vX.Y.Z.zip, che contiene il sito da caricare. Gli archivi «Source code (ZIP)» e «Source code (TAR.GZ)» che Gitea aggiunge da solo contengono il codice sorgente, non il sito: non vanno caricati sull'hosting. - Caricare lo zip
sito-studio-grasso-vX.Y.Z.zipsull'hosting come descritto indocs/DEPLOY.md(o automaticamente, se è stato attivato il deploy automatico).