Source

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:

  1. Deskargatu eta instalatu Node.js , gure mendekotasunak kudeatzeko erabiltzen duguna.
  2. Joan erroko /bootstrapdirektoriora eta exekutatu package.jsonnpm install -en zerrendatutako gure menpekotasun lokalak instalatzeko .
  3. 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/distkonpilatutako fitxategiekin direktorioa sortzen du . Sass , Autoprefixer eta UglifyJS erabiltzen ditu .
npm test Plus bezala npm run distprobak 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 CSSaren funtsezko atalak aldi bakar batean idazteko aukera ematen digunez, v3-n aurkitutakoak bezalako hornitzaileen 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:

  1. Exekutatu goiko tresnen konfigurazioa Jekyll (gunearen eraikitzailea) eta Ruby-ren beste mendekotasun batzuk instalatzeko bundle install.
  2. Erroko /bootstrapdirektoriotik, exekutatu npm run docs-servekomando lerroan.
  3. 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.