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 uses Autoprefixer (included in our build process) to automatically add vendor prefixes to some CSS properties at build time. Doing so saves us time and code by allowing us to write key parts of our CSS a single time while eliminating the need for vendor mixins like those found in v3.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /.browserslistrc for details.

Local documentation

Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  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:9001pārlūkprogrammā un var.

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.