italia/docs.italia.it repository overview

⁠Docs Italia

Docs Italia è un servizio a disposizione delle Pubbliche Amministrazioni per pubblicare documenti tecnici e amministrativi, e offre ai cittadini la possibilità di leggere e commentare documenti pubblici.

Questo repository ospita la piattaforma di pubblicazione ed è un fork del progetto open-source ReadTheDocs⁠, di cui modifica a fondo le modalità di pubblicazione e l'esperienza utente.

⁠Indice

• Come iniziare⁠
• Segnalazione bug⁠
• Repository GitHub⁠

⁠Come iniziare

Se sei interessato alla pubblicazione su Docs Italia, ti rimandiamo alla Guida alla Pubblicazione; se invece vuoi contribuire al progetto, dai un'occhiata alle indicazioni su come contribuire a Docs Italia⁠ e inizia installando la piattaforma con gli scripts di deploy⁠. Alcune delle tematiche principali sono state identificate e descritte nelle Wiki di progetto⁠.

⁠Repository GitHub

Il progetto Docs Italia si compone inoltre di altre componenti e guide che lo rendono un servizio completo a disposizione delle Pubbliche Amministrazioni:

• Gli scripts di deploy della piattaforma: https://github.com/italia/docs-italia-deploy-scripts⁠
• Il tema Sphinx per i documenti: https://github.com/italia/docs-italia-theme⁠ (il nuovo tema è attualmente sul branch bootstrap-italia)
• Un convertitore per documenti nei formati più diffusi: https://github.com/italia/docs-italia-comandi-conversione⁠
• Un'applicazione Django basata sul convertitore sopra indicato: https://github.com/italia/docs-italia-convertitore-web⁠
• La guida per la pubblicazione su Docs Italia: https://github.com/italia/docs-italia-guide⁠ (pubblicata qui⁠)
• Uno "starter kit" per la pubblicazione: https://github.com/italia/docs-italia-starter-kit⁠

⁠Segnalazione bug

Vuoi segnalare un bug?

Puoi aprire una issue⁠ descrivendo ciò che non funziona: trovi maggiori informazioni qui⁠.