Cuntribuisce
Aiutate à sviluppà Bootstrap cù a nostra documentazione di custruisce scripts è testi.
Configurazione di l'attrezzi
Bootstrap usa script npm per custruisce a documentazione è cumpilà i fugliali fonte. U nostru package.json alberga sti scripts per a compilazione di codice, l'esecuzione di testi, è più. Questi ùn sò micca destinati à l'usu fora di u nostru repository è documentazione.
Per utilizà u nostru sistema di custruzzione è eseguisce a nostra ducumentazione in u locu, avete bisognu di una copia di i fugliali fonte di Bootstrap è Node. Segui questi passi è duvete esse prontu à rock:
- Scaricate è installate Node.js , chì avemu aduprà per gestisce e nostre dependenzii.
- Scaricate e fonti di Bootstrap o fork u repository di Bootstrap .
- Navigate à u
/bootstraprepertoriu radicale è eseguitenpm installper installà e nostre dipendenze lucali listate in package.json .
Quandu hà finitu, puderete eseguisce i vari cumandamenti furniti da a linea di cummanda.
Utilizà script npm
U nostru package.json include numerosi travaglii per sviluppà u prugettu. Eseguite npm runper vede tutti i script npm in u vostru terminal. I travaglii primari includenu:
| Task | Descrizzione |
|---|---|
npm start |
Compile CSS è JavaScript, custruisce a documentazione, è principia un servitore lucale. |
npm run dist |
Crea u dist/cartulare cù i schedari compilati. Richiede Sass , Autoprefixer è Terser . |
npm test |
Esegue i testi in u locu dopu a corsanpm run dist |
npm run docs-serve |
Custruisce è gestisce a documentazione in u locu. |
Sass
Bootstrap usa Dart Sass per cumpilà i nostri fugliali di fonte Sass in i fugliali CSS (inclusi in u nostru prucessu di creazione), è vi ricumandemu di fà u stessu sè compile Sass cù u vostru propiu pipeline di asset. Avemu usatu prima Node Sass per Bootstrap v4, ma LibSass è i pacchetti custruiti sopra, cumpresu Node Sass, sò avà obsoleti .
Dart Sass usa una precisione di arrotondamentu di 10 è per ragioni di efficienza ùn permette micca l'aghjustamentu di stu valore. Ùn diminuite micca sta precisione durante u prucessu ulteriore di u nostru CSS generatu, cum'è durante a minificazione, ma se sceglite di fà cusì, ricumandemu di mantene una precisione di almenu 6 per prevene prublemi cù l'arrotondamentu di u navigatore.
Autoprefixer
Bootstrap usa Autoprefixer (cumpresu in u nostru prucessu di creazione) per aghjunghje automaticamente prefissi di venditore à alcune proprietà CSS à u tempu di creazione. Fendu cusì ci risparmia u tempu è u codice, chì ci permette di scrive parti chjave di u nostru CSS una sola volta mentre eliminendu a necessità di mixins di venditori cum'è quelli truvati in v3.
Mantenemu a lista di i navigatori supportati da Autoprefixer in un schedariu separatu in u nostru repository GitHub. Vede .browserslistrc per i dettagli.
RTLCSS
Bootstrap usa RTLCSS per processà CSS compilati è cunvertisce in RTL - basu rimpiazzà e proprietà di a direzzione horizontale (per esempiu padding-left) cù u so oppostu. Ci permette di scrive solu u nostru CSS una sola volta è fà tweaks minori utilizendu direttive di cuntrollu è valore RTLCSS.
Documentazione locale
L'esecuzione di a nostra documentazione in u locu richiede l'usu di Hugo, chì hè stallatu via u pacchettu hugo-bin npm. Hugo hè un generatore di siti statici estremamente veloce è abbastanza estensibile chì ci furnisce: include basi, schedarii basati in Markdown, mudelli è più. Eccu cumu per inizià:
- Eseguite a cunfigurazione di l' uttellu sopra per installà tutte e dipendenze.
- Da u cartulare radicali
/bootstrap, eseguitenpm run docs-servein a linea di cummanda. - Aprite
http://localhost:9001/in u vostru navigatore, è voilà.
Sapete più nantu à l'usu di Hugo leghjendu a so documentazione .
Risoluzione di prublemi
In casu di prublemi cù l'installazione di dipendenze, disinstalla tutte e versioni di dependenza precedente (globale è locale). Allora, ripete npm install.