🖖 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

1. Installa le dipendenze

npm i

2. Inizia lo sviluppo

   Per avviare il progetto esegui:

npm run dev

Il sito ora è disponibile su http://localhost:8000!

3. Prepara le anteprime del design system

   Scarica e genera gli esempi tramite l'API di Bootstrap Italia.

npm run prepare-content

4. 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.

5. Valida il tuo lavoro

   Per il linting e "prettify" del codice:

npm run lint:fix

npm run prettier:fix

6. Deployment e processi automatici (solo maintainer)

   • Aggiornamento Bootstrap Italia: L'azione bsi-update aggiorna 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).

7. Ulteriori informazioni su Gatsby (in Inglese)

• Documentazione
• Tutorial
• Guide
• Riferimenti API
• Libreria Plugin
• Cheat Sheet