Source

Sukurti įrankius

Sužinokite, kaip naudoti „Bootstrap“ įtrauktus npm scenarijus kuriant mūsų dokumentaciją, kompiliuojant šaltinio kodą, atliekant testus ir kt.

Įrankių sąranka

„ Bootstrap “ savo kūrimo sistemai naudoja NPM scenarijus . Mūsų package.json apima patogius darbo su sistema metodus, įskaitant kodo kompiliavimą, testų vykdymą ir kt.

Jei norite naudoti mūsų kūrimo sistemą ir paleisti dokumentaciją vietoje, jums reikės „Bootstrap“ šaltinio failų ir „Node“ kopijos. Atlikite šiuos veiksmus ir būsite pasiruošę sūpuoti:

  1. Atsisiųskite ir įdiekite Node.js , kurią naudojame savo priklausomybėms valdyti.
  2. Eikite į šakninį /bootstrapkatalogą ir paleiskite npm install, kad įdiegtumėte mūsų vietines priklausomybes, nurodytas pakete.json .
  3. Įdiekite Ruby , įdiekite Bundler su gem install bundlerir galiausiai paleiskite bundle install. Taip bus įdiegtos visos „Ruby“ priklausomybės, pvz., „Jekyll“ ir papildiniai.
    • „Windows“ naudotojai: perskaitykite šį vadovą , kad „Jekyll“ būtų sukurtas ir paleistas be problemų.

Baigę galėsite paleisti įvairias komandas, pateiktas komandinėje eilutėje.

NPM scenarijų naudojimas

Mūsų package.json apima šias komandas ir užduotis:

Užduotis apibūdinimas
npm run dist npm run distsukuria /distkatalogą su sukompiliuotais failais. Naudoja Sass , Autoprefixer ir UglifyJS .
npm test Lygiai taip pat, kaip npm run distir jis atlieka bandymus vietoje
npm run docs Sukuria ir sujungia CSS ir JavaScript, skirtus dokumentams. Tada galite paleisti dokumentaciją vietoje naudodami npm run docs-serve.

Vykdykite npm run, kad pamatytumėte visus npm scenarijus.

Automatinis prefiksatorius

„ Bootstrap“ naudoja „Autoprefixer“ (įtrauktą į mūsų kūrimo procesą), kad kūrimo metu automatiškai pridėtų tiekėjo priešdėlius prie kai kurių CSS ypatybių. Taip sutaupome laiko ir kodo, nes leidžiame vieną kartą parašyti pagrindines CSS dalis ir nereikia naudoti tiekėjų rinkinių, tokių kaip 3 v. versijoje.

„Autoprefixer“ palaikomų naršyklių sąrašą laikome atskirame „GitHub“ saugyklos faile. Norėdami gauti daugiau informacijos, žr . /package.json .

Vietinė dokumentacija

Norint vykdyti dokumentaciją vietoje, reikia naudoti Jekyll – pakankamai lankstų statinių svetainių generatorių, kuris suteikia mums: pagrindinius įtraukimus, Markdown pagrįstus failus, šablonus ir kt. Štai kaip tai pradėti:

  1. Vykdykite anksčiau pateiktą įrankių sąranką , kad įdiegtumėte Jekyll (svetainės kūrimo priemonę) ir kitas Ruby priklausomybes su bundle install.
  2. Iš šakninio /bootstrapkatalogo paleiskite npm run docs-servekomandų eilutę.
  3. Atidarykite http://localhost:9001savo naršyklėje ir galia.

Sužinokite daugiau apie Jekyll naudojimą skaitydami jo dokumentus .

Problemų sprendimas

Jei iškiltų problemų diegiant priklausomybes, pašalinkite visas ankstesnes priklausomybių versijas (pasaulinę ir vietinę). Tada paleiskite iš naujo npm install.