Repository files navigation

English version / Versione inglese

Questo repository contiene il codice sorgente del sitoDesigners 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 diBootstrap Italia,Gatsby e l'ecosistemaNode.js.

È possibile seguire e contribuire alle lavorazioni in corso nellaboard di progetto.

Commenti e proposte relative all'evoluzione del sito e delle risorse possono essere fatti aprendo unanuova issue, o esplorando leissue esistenti. Se vuoi contribuire e proporre una modifica, è sufficiente aprire unapull request.

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.

Il contenuto del sito si trova insrc/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.

1. Installa le dipendenze

npm i

2. Inizia lo sviluppo

   Per avviare il progetto esegui:

npm run dev

Il sito ora è disponibile suhttp://localhost:8000!

3. Prepara le anteprime del design system

   Scarica e genera gli esempi tramite l'API diBootstrap 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 directorypublic.

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'azionebsi-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 suhttps://designers.italia.it).

7. Ulteriori informazioni su Gatsby (in Inglese)

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