Инструменти за изграждане
Научете как да използвате включените npm скриптове на Bootstrap, за да създадете нашата документация, да компилирате изходния код, да изпълнявате тестове и др.
Bootstrap използва NPM скриптове за своята система за изграждане. Нашият package.json включва удобни методи за работа с рамката, включително компилиране на код, изпълнение на тестове и др.
За да използвате нашата система за изграждане и да стартирате нашата документация локално, ще ви трябва копие на изходните файлове на Bootstrap и Node. Следвайте тези стъпки и трябва да сте готови за разтърсване:
- Изтеглете и инсталирайте Node.js , който използваме за управление на нашите зависимости.
- Отидете до основната
/bootstrap
директория и стартирайте,npm install
за да инсталирате нашите локални зависимости, изброени в package.json . - Инсталирайте Ruby , инсталирайте Bundler с
gem install bundler
и накрая стартирайтеbundle install
. Това ще инсталира всички зависимости на Ruby, като Jekyll и добавки.- Потребители на Windows: Прочетете това ръководство , за да накарате Jekyll да работи без проблеми.
Когато приключите, ще можете да изпълнявате различните команди, предоставени от командния ред.
Нашият 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. Вижте /package.json за подробности.
Изпълнението на нашата документация локално изисква използването на Jekyll, прилично гъвкав статичен генератор на сайтове, който ни предоставя: основни включвания, базирани на Markdown файлове, шаблони и др. Ето как да започнете:
- Преминете през настройката на инструментите по-горе, за да инсталирате Jekyll (конструктора на сайтове) и други зависимости на Ruby с
bundle install
. - От главната
/bootstrap
директория стартирайтеnpm run docs-serve
в командния ред. - Отворете
http://localhost:9001
в браузъра си и готово.
Научете повече за използването на Jekyll, като прочетете неговата документация .
Ако срещнете проблеми с инсталирането на зависимости, деинсталирайте всички предишни версии на зависимости (глобални и локални). След това изпълнете отново npm install
.