Инструменты сборки

Узнайте, как использовать запущенные скрипты npm для загрузки нашей документации, компиляции исходного кода, запуска тестов и т.п.

Установка инструментария

Bootstrap в своей автоматической системе сборки использует скрипты NPM. package.json содержит удобные методы для работы с NPM, включая компиляцию, тесты и прочее.

Для запуска автоматической системы сборки и запуска нашей документации локально, вам понадобится копия исходников Bootstrap и Node:

  1. Установите Node, для управления зависимостями BS.
  2. Перейдите в директорию /bootstrap и запустите команду npm install для установки локальных зависимостей, перечисленных в package.json.
  3. Установите Ruby, Bundler (gem install bundler) и запустите bundle install. Это установит зависимости Ruby, такие как Jekyll, и плагины.
    • В Windows: читайте гайд для установки и запуска Jekyll.

По завершении вы будете способны запускать в CMD разные команды, которые имеются там в наличии.

Использование скриптов NPM

Вот команды CMD для пакета package.json:

Имя Описание
npm run dist Создает папку /dist, с компилированными файлами. Используйте Sass, Autoprefixer, и terser.
npm test Для запуска тестов npm test локально и компиляции CSS и JS в папку /dist.
npm run docs Собирает и тестирует CSS, JS и другие нужные для приложения ассеты (файлы/объекты, которые необходимы для работы приложения, типа файл со стилями для сайта), используемые при запуске документации локально командой npm run docs-serve.

Запустите npm run чтобы увидеть все скрипты npm.

Автопрефиксер

Bootstrap использует Автопрефиксер (который участвует в процессе автоматической сборки) для автоматического добавления «вендорных префиксов» в некоторые свойства CSS во время процесса сборки. Это сберегает наше время, позволяя писать ключевые куски кода CSS один раз, и отменяя нужду в вендорных миксинах, в отличие от BS3.

Список браузеров, в которых есть поддержка автопрефиксера, здесь: .browserslistrc.

Локальная документация

Для запуска нашей документации локально вам потребуется Jekyll, генератор гибких статических сайтов, обеспечивающий: базовые включения, файлы markdown, шаблоны и нечто еще. Вот как запустить Jekyll:

  1. Смотрите «Установку инструментария» (выше) для инструкций по установке Jekyll («строитель» сайтов) и других зависимостей Ruby командой bundle install.
  2. Запустите команду npm run docs-serve в CMD из корневой директории /bootstrap.
  3. Откройте http://localhost:9001 в вашем браузере.

Узнайте больше про Jekyll здесь.

Отслеживание багов

Если возникнут проблемы с установкой зависимостей, удалите все предыдущие версии зависимостей (глобальные и локальные). Тогда попробуйте снова npm install.