Source

Veidot rīkus

Uzziniet, kā izmantot Bootstrap iekļautos npm skriptus, lai izveidotu mūsu dokumentāciju, apkopotu pirmkodu, palaistu testus un daudz ko citu.

Instrumentu iestatīšana

Bootstrap savā veidošanas sistēmā izmanto NPM skriptus . Mūsu pakete.json ietver ērtas metodes darbam ar ietvaru, tostarp koda kompilēšanu, testu izpildi un daudz ko citu.

Lai izmantotu mūsu būvēšanas sistēmu un lokāli palaistu mūsu dokumentāciju, jums būs nepieciešama Bootstrap avota failu un Node kopija. Veiciet šīs darbības, un jums vajadzētu būt gatavam šūpošanai:

  1. Lejupielādējiet un instalējiet Node.js , ko izmantojam, lai pārvaldītu savas atkarības.
  2. Pārejiet uz saknes /bootstrapdirektoriju un palaidiet npm install, lai instalētu mūsu vietējās atkarības, kas norādītas failā package.json .
  3. Instalējiet Ruby , instalējiet Bundler ar gem install bundlerun visbeidzot palaidiet bundle install. Tādējādi tiks instalētas visas Ruby atkarības, piemēram, Jekyll un spraudņi.
    • Windows lietotājiem: izlasiet šo rokasgrāmatu , lai Jekyll sāktu darboties bez problēmām.

Kad tas būs pabeigts, varēsit palaist dažādas komandas, kas tiek nodrošinātas no komandrindas.

Izmantojot NPM skriptus

Mūsu package.json ietver šādas komandas un uzdevumus:

Uzdevums Apraksts
npm run dist npm run distizveido /distdirektoriju ar apkopotajiem failiem. Izmanto Sass , Autoprefixer un UglifyJS .
npm test Tāpat kā npm run distplus tas veic testus lokāli
npm run docs Veido un savieno CSS un JavaScript dokumentiem. Pēc tam varat palaist dokumentāciju lokāli, izmantojot npm run docs-serve.

Palaist npm run, lai redzētu visus npm skriptus.

Autoprefiksators

Bootstrap izmanto Autoprefixer (iekļauts mūsu veidošanas procesā), lai automātiski pievienotu pārdevēja prefiksus dažiem CSS rekvizītiem izveides laikā. Šādi rīkojoties, mēs ietaupām laiku un kodu, ļaujot mums rakstīt galvenās mūsu CSS daļas vienu reizi, vienlaikus novēršot vajadzību pēc pārdevēju kombinācijām, piemēram, tām, kas atrodamas v3.

Mēs uzturam to pārlūkprogrammu sarakstu, kuras atbalsta, izmantojot Autoprefixer, atsevišķā failā mūsu GitHub repozitorijā. Plašāku informāciju skatiet vietnē /package.json .

Vietējā dokumentācija

Lai mūsu dokumentācija darbotos lokāli, ir jāizmanto Jekyll — pietiekami elastīgs statisko vietņu ģenerators, kas nodrošina: pamata ietver, uz Markdown balstītus failus, veidnes un daudz ko citu. Lūk, kā to sākt:

  1. Izpildiet iepriekš minēto rīku iestatīšanu , lai instalētu Jekyll (vietņu veidotāju) un citas Ruby atkarības ar bundle install.
  2. No saknes /bootstrapdirektorija palaidiet npm run docs-servekomandrindā.
  3. Atveriet http://localhost:9001savā pārlūkprogrammā un voilà.

Uzziniet vairāk par Jekyll lietošanu, izlasot tā dokumentāciju .

Problēmu novēršana

Ja rodas problēmas ar atkarību instalēšanu, atinstalējiet visas iepriekšējās atkarības versijas (globālās un vietējās). Pēc tam palaidiet vēlreiz npm install.