Source

Orodja za gradnjo

Naučite se uporabljati Bootstrapove vključene skripte npm za izdelavo naše dokumentacije, prevajanje izvorne kode, izvajanje testov in več.

Nastavitev orodja

Bootstrap uporablja skripte npm za svoj gradbeni sistem. Naš package.json vključuje priročne metode za delo z ogrodjem, vključno s prevajanjem kode, izvajanjem testov in več.

Če želite uporabljati naš gradbeni sistem in lokalno izvajati našo dokumentacijo, potrebujete kopijo izvornih datotek in vozlišča Bootstrap. Sledite tem korakom in že boste pripravljeni na začetek:

  1. Prenesite in namestite Node.js , ki ga uporabljamo za upravljanje naših odvisnosti.
  2. Pomaknite se do korenskega /bootstrapimenika in zaženite npm install, da namestite naše lokalne odvisnosti, navedene v package.json .
  3. Namestite Ruby , namestite Bundler z gem install bundlerin končno zaženite bundle install. S tem boste namestili vse odvisnosti Rubyja, kot so Jekyll in vtičniki.
    • Uporabniki operacijskega sistema Windows: preberite ta priročnik , da boste Jekyll začeli delovati brez težav.

Ko končate, boste lahko izvajali različne ukaze iz ukazne vrstice.

Uporaba skriptov npm

Naš package.json vključuje naslednje ukaze in opravila:

Naloga Opis
npm run dist npm run distustvari /dist/imenik s prevedenimi datotekami. Uporablja Sass , Autoprefixer in UglifyJS .
npm test Enako kot npm run distplus izvaja teste lokalno
npm run docs Gradi in lintira CSS in JavaScript za dokumente. Nato lahko dokumentacijo zaženete lokalno prek npm run docs-serve.

Zaženite npm run, da vidite vse skripte npm.

Samodejna predpona

Bootstrap uporablja Autoprefixer (vključen v naš postopek gradnje) za samodejno dodajanje predpon prodajalca v nekatere lastnosti CSS v času gradnje. To nam prihrani čas in kodo, saj nam omogoča, da ključne dele našega CSS napišemo enkrat, hkrati pa odpravimo potrebo po miksinih prodajalcev, kot so tisti v v3.

Seznam brskalnikov, ki jih podpira Autoprefixer, hranimo v ločeni datoteki v našem repozitoriju GitHub. Za podrobnosti glejte .browserslistrc .

Lokalna dokumentacija

Lokalno vodenje naše dokumentacije zahteva uporabo Jekylla, spodobno prilagodljivega generatorja statičnih spletnih mest, ki nam nudi: osnovne vključitve, datoteke, ki temeljijo na Markdownu, predloge in še več. Tukaj je opisano, kako začeti:

  1. Zaženite zgornjo nastavitev orodij , da namestite Jekyll (graditelj spletnega mesta) in druge odvisnosti Rubyja z bundle install.
  2. Iz korenskega /bootstrapimenika zaženite npm run docs-serveukazno vrstico.
  3. Odprite http://localhost:9001v brskalniku in voilà.

Izvedite več o uporabi Jekylla tako, da preberete njegovo dokumentacijo .

Odpravljanje težav

Če naletite na težave pri namestitvi odvisnosti, odstranite vse prejšnje različice odvisnosti (globalne in lokalne). Nato znova zaženite npm install.