Ehitustööriistad
Siit saate teada, kuidas kasutada Bootstrapi kaasasolevaid npm-skripte meie dokumentatsiooni koostamiseks, lähtekoodi kompileerimiseks, testide käitamiseks ja muuks.
Bootstrap kasutab oma ehitussüsteemis NPM-skripte . Meie package.json sisaldab mugavaid meetodeid raamistikuga töötamiseks, sealhulgas koodi koostamine, testide käitamine ja palju muud.
Meie ehitussüsteemi kasutamiseks ja dokumentatsiooni kohapeal käitamiseks vajate Bootstrapi lähtefailide ja sõlme koopiat. Järgige neid samme ja peaksite olema rokkimiseks valmis:
- Laadige alla ja installige Node.js , mida kasutame oma sõltuvuste haldamiseks.
- Navigeerige juurkataloogi
/bootstrapja käivitage failis package.jsonnpm installloetletud kohalike sõltuvuste installimiseks . - Installige Ruby , installige Bundler koos rakendusega
gem install bundlerja lõpuks käivitagebundle install. See installib kõik Ruby sõltuvused, nagu Jekyll ja pistikprogrammid.- Windowsi kasutajad: Jekylli probleemideta käivitamiseks lugege seda juhendit .
Kui olete lõpetanud, saate käivitada erinevaid käsurealt antud käske.
Meie package.json sisaldab järgmisi käske ja ülesandeid:
| Ülesanne | Kirjeldus |
|---|---|
npm run dist |
npm run distloob /distkompileeritud failidega kataloogi. Kasutab Sassi , Autoprefixerit ja UglifyJS-i . |
npm test |
Sama nagu npm run distpluss, see käivitab testid kohapeal |
npm run docs |
Ehitab ja ühendab dokumentide jaoks CSS-i ja JavaScripti. Seejärel saate dokumentatsiooni kohapeal käitada npm run docs-serve. |
Käivitage npm run, et näha kõiki npm-skripte.
Bootstrap kasutab automaatprefikserit (mis sisaldub meie ehitusprotsessis), et lisada mõnele CSS-i atribuudile koostamise ajal automaatselt hankija eesliited. See säästab meie aega ja koodi, võimaldades meil kirjutada oma CSS-i põhiosad ühe korra, kõrvaldades samal ajal vajaduse hankijate miksinide järele, nagu need, mida leidub versioonis 3.
Hoiame Autoprefixeri kaudu toetatud brauserite loendit eraldi failis meie GitHubi hoidlas. Üksikasju leiate aadressilt /package.json .
Meie dokumentatsiooni kohalikuks käitamiseks on vaja kasutada Jekylli, parajalt paindlikku staatilise saidi generaatorit, mis pakub meile: põhi sisaldab, Markdowni-põhiseid faile, malle ja palju muud. Selle käivitamiseks tehke järgmist.
- Käivitage ülaltoodud tööriistade seadistus , et installida Jekyll (saidi koostaja) ja muud Ruby sõltuvused rakendusega
bundle install. /bootstrapKäivitage juurkataloogistnpm run docs-servekäsureal.- Avage
http://localhost:9001oma brauseris ja voilà.
Lisateavet Jekylli kasutamise kohta leiate selle dokumentatsioonist .
Kui teil tekib sõltuvuste installimisel probleeme, desinstallige kõik eelmised sõltuvuse versioonid (globaalne ja kohalik). Seejärel käivitage uuesti npm install.