in English

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:

  1. Scaricate è installate Node.js , chì avemu aduprà per gestisce e nostre dependenzii.
  2. Scaricate e fonti di Bootstrap o fork u repository di Bootstrap .
  3. Navigate à u /bootstraprepertoriu radicale è eseguite npm 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 i seguenti cumandamenti è compiti:

Task Descrizzione
npm run dist npm run distcrea 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 runper vede tutti i script npm.

Cuminciate cù Bootstrap via npm cù u nostru prughjettu di partenza! Testa à u repository di mudelli twbs/bootstrap-npm-starter per vede cumu custruisce è persunalizà Bootstrap in u vostru propiu prughjettu npm. Include compilatore Sass, Autoprefixer, Stylelint, PurgeCSS è Icone Bootstrap.

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à:

  1. Eseguite a cunfigurazione di l' uttellu sopra per installà tutte e dipendenze.
  2. Da u cartulare radicali /bootstrap, eseguite npm run docs-servein a linea di cummanda.
  3. 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.