| 1 | # Bootstrap Italia
|
| 2 |
|
| 3 | [](https://github.com/italia/bootstrap-italia/releases)
|
| 4 | [](https://github.com/italia/bootstrap-italia/actions)
|
| 5 | [](https://github.com/italia/bootstrap-italia/issues)
|
| 6 | [](https://developersitalia.slack.com/messages/C7VPAUVB3/)
|
| 7 | [](https://slack.developers.italia.it/)
|
| 8 |
|
| 9 | _🇬🇧 [English version](README.EN.md)_
|
| 10 |
|
| 11 | _📦 [Vai alla versione 1.x di Bootstrap Italia (basata su Bootstrap 4)](https://github.com/italia/bootstrap-italia/tree/1.x)_
|
| 12 |
|
| 13 | Bootstrap Italia è un tema basato su [Bootstrap 5](https://getbootstrap.com/docs/5.1/getting-started/introduction/) conforme alle [linee guida di design per i siti internet e i servizi digitali delle Pubbliche Amministrazioni](https://docs.italia.it/italia/design/lg-design-servizi-web/).
|
| 14 |
|
| 15 | Bootstrap Italia eredita tutte le funzionalità, componenti, mixins, grid system, e altro già presenti in Bootstrap 5, e le personalizza secondo le "Linee guida di design per i siti internet e i servizi digitali della PA" e le indicazioni presenti nel manuale operativo di design messo a disposizione da Designers Italia. Puoi scoprire di più tramite la [pagina dedicata di Designers Italia](https://designers.italia.it/linee-guida).
|
| 16 |
|
| 17 | La roadmap del progetto è consultabile nel [piano attività di Designers Italia](https://designers.italia.it/piano-attivita/).
|
| 18 |
|
| 19 | **[Vedi la documentazione completa »](https://italia.github.io/bootstrap-italia/)**
|
| 20 |
|
| 21 | oppure
|
| 22 |
|
| 23 | **[Scarica l'ultima versione della libreria »](https://github.com/italia/bootstrap-italia/releases)**
|
| 24 |
|
| 25 | ## Indice
|
| 26 |
|
| 27 | - [Segnalazione bug e richieste](#segnalazione-bug-e-richieste-di-aiuto)
|
| 28 | - [Come contribuire](#come-contribuire)
|
| 29 | - [Licenze software dei componenti di terze parti](#licenze-software-dei-componenti-di-terze-parti)
|
| 30 |
|
| 31 | ## Segnalazione bug e richieste di aiuto
|
| 32 |
|
| 33 | Vuoi segnalare un bug o fare una richiesta?
|
| 34 |
|
| 35 | Prima di tutto assicurati che sia un problema relativo al tema Bootstrap Italia e non alla libreria Bootstrap da cui deriva
|
| 36 | (in tal caso puoi fare riferimento al [repository di Bootstrap](https://github.com/twbs/bootstrap)), poi
|
| 37 | dai un'occhiata a come [creare una issue](https://github.com/italia/bootstrap-italia/blob/main/CONTRIBUTING.md#creare-una-issue).
|
| 38 |
|
| 39 | ## Come contribuire
|
| 40 |
|
| 41 | Vorresti dare una mano su Bootstrap Italia? **Sei nel posto giusto!**
|
| 42 |
|
| 43 | Se non l'hai già fatto, inizia spendendo qualche minuto per approfondire la tua conoscenza sulle "Linee guida di design per i siti internet e i servizi digitali della PA" e del manuale operativo di design a supporto partendo dalla [pagina dedicata di Designers Italia](https://designers.italia.it/linee-guida), e fai riferimento alle [indicazioni su come contribuire a Bootstrap Italia](https://github.com/italia/bootstrap-italia/blob/main/CONTRIBUTING.md).
|
| 44 |
|
| 45 | A questo punto, è necessario impostare il tuo ambiente locale per la compilazione dei file sorgente e la generazione
|
| 46 | della documentazione. Puoi usare [Docker](https://docs.docker.com/get-started/) per far partire l'ambiente di sviluppo.
|
| 47 |
|
| 48 | ```sh
|
| 49 | docker-compose up
|
| 50 | ```
|
| 51 |
|
| 52 | ## Licenze software dei componenti di terze parti
|
| 53 |
|
| 54 | ### Componenti distribuiti con Bootstrap Italia
|
| 55 |
|
| 56 | Vengono di seguito elencati i componenti distribuiti con Bootstrap Italia che hanno una propria licenza diversa da CC0.
|
| 57 |
|
| 58 | - [Bootstrap 5](https://getbootstrap.com) © Twitter, Inc., licenza MIT
|
| 59 | - [Popper.js](https://popper.js.org) © Floating UI contributors, licenza MIT
|
| 60 | - [SplideJS](https://splidejs.com) © Naotoshi Fujita, licenza MIT
|
| 61 | - [Accessible Autocomplete](https://alphagov.github.io/accessible-autocomplete) © Crown Copyright (Government Digital Service), licenza MIT
|
| 62 | - [AnimeJS](https://animejs.com) © Julian Garnier, licenza MIT
|
| 63 | - [Just Validate](https://just-validate.dev) © Horprogs, licenza MIT
|
| 64 | - [Masonry Layout](https://masonry.desandro.com) © David DeSandro, licenza MIT
|
| 65 | - [Progressbar.js](https://kimmobrunfeldt.github.io/progressbar.js) © Kimmo Brunfeldt, licenza MIT
|
| 66 |
|
| 67 | ### Principali dipendenze per la fase di compilazione e sviluppo
|
| 68 |
|
| 69 | - Generatore di siti statici per ruby [Jekyll](https://jekyllrb.com), © Tom Preston-Werner and Jekyll contributors, licenza MIT
|
| 70 | - Tool per il testing della correttezza formale dell'HTML [html-proofer](https://github.com/gjtorikian/html-proofer), © Garen Torikian, licenza MIT
|
| 71 | - Tool per il reload automatico del browser [Browser Sync](https://www.browsersync.io/) Apache License Version 2.0
|
| 72 | - Gestione del versionamento [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog/) © conventional-changelog team, ISC License
|
| 73 | - Build system per le librerie Javascript e CSS [Rollup.js](https://rollupjs.org/), © [questi contributori](https://github.com/rollup/rollup/graphs/contributors), licenza MIT
|
| 74 | - Code formatter per Javascript [Prettier](https://prettier.io/), © James Long and contributors, licenza MIT
|
| 75 | - Compilazione SASS [sass](https://github.com/sass/dart-sass), © Google Inc., licenza MIT
|
| 76 | - GitHub REST API client per JavaScript [Octokit rest.js](https://octokit.github.io/rest.js/) © Cloud9 IDE, Inc. (Mike de Boer), 2017-2018 Octokit contributors, licenza MIT
|
| 77 |
|
| 78 | ### Componenti utilizzati per la documentazione
|
| 79 |
|
| 80 | Di seguito sono elencati invece i componenti utilizzati per il sito della documentazione ma non ridistribuiti nella libreria Bootstrap Italia
|
| 81 |
|
| 82 | - [tsParticles](https://particles.js.org/) © Matteo Bruni, licenza MIT
|
| 83 | - [clipboard.js](https://clipboardjs.com/) © Zeno Rocha, licenza MIT
|
| 84 | - [AnchorJS](https://www.bryanbraun.com/anchorjs/) © Bryan Braun, licenza MIT
|
| 85 | - [Algolia DocSearch](https://docsearch.algolia.com/) © Algolia, licenza MIT
|
| 86 |
|
| 87 | ## Licenza
|
| 88 |
|
| 89 | La licenza di Bootstrap Italia è **BSD 3-Clause** ed è visibile nel file LICENSE:
|
| 90 |
|
| 91 | [](https://github.com/italia/bootstrap-italia/blob/main/LICENSE)
|
| 92 |
|
| 93 | <a href="https://www.browserstack.com/" target="_blank"><img src="docs/assets/img/browserstack-logo.png" alt="BrowserStack logo" width="270" height="79" /></a>
|
| 94 |
|
| 95 | We are using BrowserStack for interactive cross browser testing. They are sponsoring our open source project!
|