Source

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

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

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

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

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

Спампуйце і ўсталюйце Node.js , які мы выкарыстоўваем для кіравання нашымі залежнасцямі.
Перайдзіце ў каранёвы /bootstrapкаталог і запусціце npm install, каб усталяваць нашы лакальныя залежнасці, пералічаныя ў package.json .
Усталюйце Ruby , усталюйце Bundler з дапамогай gem install bundlerі, нарэшце, запусціце bundle install. Гэта дазволіць усталяваць усе залежнасці Ruby, такія як Jekyll і плагіны.
- Карыстальнікі Windows: прачытайце гэтае кіраўніцтва , каб запусціць 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, шаблоны і многае іншае. Вось як гэта пачаць:

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

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

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

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