Source

Інструменты зборкі

Даведайцеся, як выкарыстоўваць уключаныя ў Bootstrap сцэнары npm для стварэння нашай дакументацыі, кампіляцыі зыходнага кода, выканання тэстаў і шмат іншага.

Наладка аснасткі

Bootstrap выкарыстоўвае скрыпты NPM для сваёй сістэмы зборкі. Наш package.json уключае зручныя метады працы з фрэймворкам, уключаючы кампіляцыю кода, запуск тэстаў і многае іншае.

Каб выкарыстоўваць нашу сістэму зборкі і запускаць нашу дакументацыю лакальна, вам спатрэбіцца копія зыходных файлаў Bootstrap і Node. Выканайце наступныя крокі, і вы павінны быць гатовыя да рок:

  1. Спампуйце і ўсталюйце Node.js , які мы выкарыстоўваем для кіравання нашымі залежнасцямі.
  2. Перайдзіце ў каранёвы /bootstrapкаталог і запусціце npm install, каб усталяваць нашы лакальныя залежнасці, пералічаныя ў package.json .
  3. Усталюйце Ruby , усталюйце Bundler з дапамогай gem install bundlerі, нарэшце, запусціце bundle install. Гэта дазволіць усталяваць усе залежнасці Ruby, такія як Jekyll і плагіны.

Пасля завяршэння вы зможаце запускаць розныя каманды з каманднага радка.

Выкарыстанне скрыптоў NPM

Наш package.json уключае наступныя каманды і задачы:

Задача Апісанне
npm run dist npm run distстварае /distкаталог са скампіляванымі файламі. Выкарыстоўвае Sass , Autoprefixer і UglifyJS .
npm test Тое самае, што npm run distплюс, ён запускае тэсты лакальна
npm run docs Зборкі і лінты CSS і JavaScript для дакументаў. Затым вы можаце запусціць дакументацыю лакальна праз npm run docs-serve.

Запусціце npm run, каб убачыць усе скрыпты npm.

Аўтапрэфікс

Bootstrap выкарыстоўвае Autoprefixer (уключаны ў наш працэс зборкі), каб аўтаматычна дадаваць прэфіксы пастаўшчыка да некаторых уласцівасцей CSS падчас зборкі. Гэта дазваляе зэканоміць наш час і код, дазваляючы напісаць ключавыя часткі нашага CSS за адзін раз, пазбаўляючы пры гэтым патрэбы ў міксінах пастаўшчыка, падобных да тых, што ёсць у v3.

Мы захоўваем спіс браўзераў, якія падтрымліваюцца праз Autoprefixer, у асобным файле ў нашым рэпазітары GitHub. Падрабязнасці глядзіце ў /.browserslistrc .

Мясцовая дакументацыя

Запуск нашай дакументацыі лакальна патрабуе выкарыстання Jekyll, прыстойна гнуткага генератара статычных сайтаў, які дае нам: асноўныя ўключэнні, файлы на аснове Markdown, шаблоны і многае іншае. Вось як гэта пачаць:

  1. Выканайце налады інструментаў вышэй, каб усталяваць Jekyll (канструктар сайтаў) і іншыя залежнасці Ruby з дапамогай bundle install.
  2. З каранёвага /bootstrapкаталога запусціце npm run docs-serveў камандным радку.
  3. Адкрыйце http://localhost:9001ў браўзеры і вуаля.

Даведайцеся больш аб выкарыстанні Jekyll, прачытаўшы яго дакументацыю .

Ліквідацыю непаладак

Калі ў вас узнікнуць праблемы з усталяваннем залежнасцей, выдаліце ​​ўсе папярэднія версіі залежнасцей (глабальныя і лакальныя). Потым запусціце паўторна npm install.