🖖 Sorgente del sito Designers Italia
English version / Versione inglese
Questo repository contiene il codice sorgente del sito Designers Italia, il progetto che mette a disposizione conoscenza e strumenti per creare i servizi digitali della Pubblica Amministrazione.
Il sito ospita la documentazione del design system del Paese nella sezione /design-system/come-iniziare/.
Il sito utilizza l'ultima versione di Bootstrap Italia, Gatsby e l'ecosistema Node.js.
💙 Come contribuire
È possibile seguire e contribuire alle lavorazioni in corso nella board di progetto.
Commenti e proposte relative all'evoluzione del sito e delle risorse possono essere fatti aprendo una nuova issue, o esplorando le issue esistenti. Se vuoi contribuire e proporre una modifica, è sufficiente aprire una pull request.
📖 Guide per i collaboratori
Per i collaboratori del progetto sono disponibili guide dettagliate:
- HOW-TO-MANAGE-EDITORIAL-CONTENT.md - Guida per la creazione e gestione dei contenuti editoriali (notizie, eventi, media) e del controllo delle card in evidenza nelle diverse sezioni del sito.
- HOW-TO-DESIGN-SYSTEM-RELEASE.md - Procedura per i rilasci del Design system del Paese.
✏️ Contenuti
Il contenuto del sito si trova in src/data/content/, e ogni volta che un file viene aggiornato, l'ora dell'ultima modifica viene generata automaticamente.
Se vuoi aggiornare uno di questi file senza alterare l'orario dell'ultima modifica visualizzato, includi (last-update-skip) nel messaggio del commit.
🚀 Avvio rapido
- Installa le dipendenze
npm i
-
Inizia lo sviluppo
Per avviare il progetto esegui:
npm run dev
Il sito ora è disponibile su http://localhost:8000!
-
Prepara le anteprime del design system
Scarica e genera gli esempi tramite l'API di Bootstrap Italia.
npm run prepare-content
-
Costruisci il sito statico (produzione)
Per costruire una versione statica del sito, avvia il processo di build.
npm run build
Il sito generato staticamente viene posizionato nella directory public.
-
Valida il tuo lavoro
Per il linting e "prettify" del codice:
npm run lint:fix
npm run prettier:fix
-
Deployment e processi automatici (solo maintainer)
-
Aggiornamento Bootstrap Italia: L'azione
bsi-updateaggiorna automaticamente Bootstrap Italia e rigenera le anteprime dei componenti nelle schede del Design system (giornaliera o manuale). -
Deploy produzione: lanciare in sequenza (a)
prepare-deploy(se ci sono nuove immagini, meno di 5 min, per generatore card SEO) e (b)deploy(5-30min, usa cache Gatsby, sito su https://designers.italia.it).
-
-
Ulteriori informazioni su Gatsby (in Inglese)