Custruì arnesi
Amparate cumu utilizà i scripts npm inclusi di Bootstrap per custruisce a nostra documentazione, cumpilà u codice fonte, eseguite testi, è più.
Configurazione di l'attrezzi
Bootstrap usa script npm per u so sistema di creazione. U nostru package.json include metudi convenienti per travaglià cù u framework, cumpresu a compilazione di codice, l'esecuzione di teste, è più.
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
/bootstrap
repertoriu radicale è eseguitenpm install
per 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 i seguenti cumandamenti è compiti:
Task | Descrizzione |
---|---|
npm run dist |
npm run dist crea u /dist/ cartulare cù i schedari compilati. Utiliza 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. |
Eseguite npm run
per vede tutti i script npm.
Sass
Bootstrap v4 usa Node Sass per cumpilà i nostri fugliali di fonte Sass in schedari CSS (inclusi in u nostru prucessu di creazione). Per finisce cù u stessu CSS generatu quandu compilate Sass cù u vostru propiu pipeline di asset, avete bisognu di utilizà un compilatore Sass chì sustene almenu e funzioni chì Node Sass faci. Questu hè impurtante di nutà perchè da u 26 d'ottobre di u 2020, LibSass è i pacchetti custruiti sopra - cumpresu Node Sass - sò obsoleti .
Sè avete bisognu di funzioni Sass più recenti o cumpatibilità cù i normi CSS più recenti, Dart Sass hè avà l'implementazione primaria di Sass è supporta una API JavaScript chì hè cumplettamente cumpatibile cù Node Sass (cù alcune eccezzioni listate nantu à a pagina GitHub di Dart Sass ).
Aumentemu a precisione di arrotondamentu Sass à 6 (per automaticamente, hè 5 in Node Sass) per prevene prublemi cù l'arrotondamentu di u navigatore. Se utilizate Dart Sass, questu ùn serà micca qualcosa chì avete bisognu di aghjustà, postu chì u compilatore usa una precisione di arrotondamentu di 10 è per ragioni di efficienza ùn permettenu micca esse aghjustatu.
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 chì si trovanu 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.
Documentazione lucale
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-serve
in 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
.