Source

Инструменти за изграждане

Научете как да използвате включените npm скриптове на Bootstrap, за да създадете нашата документация, да компилирате изходния код, да изпълнявате тестове и др.

Настройка на инструментите

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 и добавки.
    • Потребители на 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 файлове, шаблони и др. Ето как да започнете:

  1. Преминете през настройката на инструментите по-горе, за да инсталирате Jekyll (конструктора на сайтове) и други зависимости на Ruby с bundle install.
  2. От главната /bootstrapдиректория стартирайте npm run docs-serveв командния ред.
  3. Отворете http://localhost:9001в браузъра си и готово.

Научете повече за използването на Jekyll, като прочетете неговата документация .

Отстраняване на неизправности

Ако срещнете проблеми с инсталирането на зависимости, деинсталирайте всички предишни версии на зависимости (глобални и локални). След това изпълнете отново npm install.