Source

Ehitustööriistad

Siit saate teada, kuidas kasutada Bootstrapi kaasasolevaid npm-skripte meie dokumentatsiooni koostamiseks, lähtekoodi kompileerimiseks, testide käitamiseks ja muuks.

Tööriistade seadistamine

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:

  1. Laadige alla ja installige Node.js , mida kasutame oma sõltuvuste haldamiseks.
  2. Navigeerige juurkataloogi /bootstrapja käivitage failis package.jsonnpm install loetletud kohalike sõltuvuste installimiseks .
  3. Installige Ruby , installige Bundler koos rakendusega gem install bundlerja lõpuks käivitage bundle 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.

NPM-skriptide kasutamine

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.

Autoprefikser

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 .

Kohalik dokumentatsioon

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.

  1. Käivitage ülaltoodud tööriistade seadistus , et installida Jekyll (saidi koostaja) ja muud Ruby sõltuvused rakendusega bundle install.
  2. /bootstrapKäivitage juurkataloogist npm run docs-servekäsureal.
  3. Avage http://localhost:9001oma brauseris ja voilà.

Lisateavet Jekylli kasutamise kohta leiate selle dokumentatsioonist .

Veaotsing

Kui teil tekib sõltuvuste installimisel probleeme, desinstallige kõik eelmised sõltuvuse versioonid (globaalne ja kohalik). Seejärel käivitage uuesti npm install.