Tresnak eraiki

Ikasi Bootstrap-en barne npm scriptak nola erabiltzen gure dokumentazioa eraikitzeko, iturburu-kodea konpilatzeko, probak exekutatzeko eta abar.

Tresneriaren konfigurazioa

Bootstrap- ek NPM scriptak erabiltzen ditu bere eraikuntza sistemarako. Gure package.json -ek markoarekin lan egiteko metodo erosoak biltzen ditu, besteak beste, kodea konpilatzea, probak egitea eta abar.

Gure eraikuntza-sistema erabiltzeko eta gure dokumentazioa lokalean exekutatzeko, Bootstrap-en iturburu-fitxategien eta Noderen kopia bat beharko duzu. Jarraitu urrats hauek eta rocka egiteko prest egon beharko zenuke:

Deskargatu eta instalatu Node.js , gure mendekotasunak kudeatzeko erabiltzen duguna.
Nabigatu root /bootstrapdirektoriora eta exekutatu package.jsonnpm install -en zerrendatutako gure menpekotasun lokalak instalatzeko .
Instalatu Ruby , instalatu Bundler -ekin gem install bundlereta, azkenik, exekutatu bundle install. Honek Rubyren menpekotasun guztiak instalatuko ditu, hala nola Jekyll eta pluginak.
- Windows erabiltzaileak: irakurri gida hau Jekyll arazorik gabe martxan jartzeko.

Amaitutakoan, komando-lerrotik emandako hainbat komando exekutatu ahal izango dituzu.

NPM scriptak erabiliz

Gure package.json -ek komando eta zeregin hauek ditu:

Zeregin	Deskribapena
`npm run dist`	`npm run dist/dist`konpilatutako fitxategiekin direktorioa sortzen du . Sass , Autoprefixer eta UglifyJS erabiltzen ditu .
`npm test`	Plus bezala `npm run dist`probak exekutatzen ditu lokalean
`npm run docs`	CSS eta JavaScript dokumentuetarako eraikitzen eta lintsatzen ditu. Ondoren, dokumentazioa lokalean exekutatu dezakezu `npm run docs-serve`.

Exekutatu npm runnpm script guztiak ikusteko.

Autoaurrizkia

Bootstrap- ek Autoprefixer erabiltzen du (gure eraikuntza-prozesuan barne) saltzaileen aurrizkiak CSS propietate batzuei automatikoki gehitzeko eraikitze-unean. Hori eginez gero, denbora eta kodea aurrezten gaitu, gure CSSren funtsezko atalak aldi bakar batean idazteko aukera ematen digunez, v3-n aurkitzen diren saltzaileen mixinen beharra ezabatuz.

Autoprefixer bidez onartzen diren arakatzaileen zerrenda aparteko fitxategi batean mantentzen dugu GitHub biltegian. Ikusi /package.json xehetasunetarako.

Tokiko dokumentazioa

Gure dokumentazioa lokalean exekutatzeko Jekyll-en erabilera eskatzen du, eskaintzen digun gune-sorgailu estatiko malgu bat: oinarrizko barneak, Markdown-en oinarritutako fitxategiak, txantiloiak eta abar. Hona hemen nola hasteko:

Exekutatu goiko tresnen konfigurazioa Jekyll (gunearen eraikitzailea) eta Ruby-ren beste mendekotasun batzuk instalatzeko bundle install.
Erroko /bootstrapdirektoriotik, exekutatu npm run docs-servekomando lerroan.
Ireki http://localhost:9001arakatzailean, eta listo.

Lortu informazio gehiago Jekyll erabiltzeari buruzko dokumentazioa irakurrita .

Arazoak konpontzea

Mendekotasunak instalatzeko arazoak aurkitzen badituzu, desinstalatu aurreko mendekotasun bertsio guztiak (globalak eta lokalak). Ondoren, berriro exekutatu npm install.