Alati za pravljenje
Naučite kako koristiti uključene npm skripte Bootstrapa za izradu naše dokumentacije, kompajliranje izvornog koda, pokretanje testova i još mnogo toga.
Postavljanje alata
Bootstrap koristi npm skripte za svoj sistem izgradnje. Naš package.json uključuje zgodne metode za rad sa okvirom, uključujući kompajliranje koda, pokretanje testova i još mnogo toga.
Da biste koristili naš sistem izgradnje i lokalno pokrenuli našu dokumentaciju, trebat će vam kopija izvornih datoteka Bootstrapa i Node. Slijedite ove korake i trebali biste biti spremni za rock:
- Preuzmite i instalirajte Node.js , koji koristimo za upravljanje našim ovisnostima.
- Idite do korijenskog
/bootstrap
direktorija i pokrenitenpm install
da instalirate naše lokalne ovisnosti navedene u package.json . - Instalirajte Ruby , instalirajte Bundler sa
gem install bundler
, i konačno pokrenitebundle install
. Ovo će instalirati sve Ruby ovisnosti, kao što su Jekyll i dodaci.- Korisnici Windowsa: Pročitajte ovaj vodič da biste pokrenuli Jekyll bez problema.
Kada završite, moći ćete da pokrenete različite komande koje ste dobili iz komandne linije.
Korištenje npm skripti
Naš package.json uključuje sljedeće naredbe i zadatke:
Zadatak | Opis |
---|---|
npm run dist |
npm run dist kreira /dist/ direktorij s kompajliranim datotekama. Koristi Sass , Autoprefixer i UglifyJS . |
npm test |
Isto kao npm run dist plus pokreće testove lokalno |
npm run docs |
Izrađuje i stavlja CSS i JavaScript za dokumente. Zatim možete pokrenuti dokumentaciju lokalno putem npm run docs-serve . |
Pokrenite npm run
da vidite sve npm skripte.
Autoprefixer
Bootstrap koristi Autoprefixer (uključen u naš proces izgradnje) za automatsko dodavanje prefiksa dobavljača nekim CSS svojstvima u vrijeme izrade. Na taj način štedimo vrijeme i kod, omogućavajući nam da napišemo ključne dijelove našeg CSS-a samo jednom, dok eliminiramo potrebu za miksinama dobavljača poput onih u v3.
Mi održavamo listu pretraživača podržanih kroz Autoprefixer u zasebnoj datoteci unutar našeg GitHub repozitorija. Pogledajte .browserslistrc za detalje.
Lokalna dokumentacija
Lokalno pokretanje naše dokumentacije zahtijeva korištenje Jekyll-a, prilično fleksibilnog generatora statičkih stranica koji nam pruža: osnovne uključuje, datoteke zasnovane na Markdown-u, predloške i još mnogo toga. Evo kako započeti:
- Prođite kroz gornju postavku alata da biste instalirali Jekyll (graditelj stranice) i druge Ruby ovisnosti sa
bundle install
. - Iz korijenskog
/bootstrap
direktorija pokrenitenpm run docs-serve
u komandnoj liniji. - Otvorite
http://localhost:9001
u svom pretraživaču i voilà.
Saznajte više o korištenju Jekyll-a čitajući njegovu dokumentaciju .
Rješavanje problema
Ako naiđete na probleme s instaliranjem ovisnosti, deinstalirajte sve prethodne verzije ovisnosti (globalne i lokalne). Zatim, ponovite npm install
.