Инструменты сборки
Узнайте, как использовать запущенные скрипты npm для загрузки нашей документации, компиляции исходного кода, запуска тестов и т.п.
Установка инструментария
Bootstrap в своей автоматической системе сборки использует скрипты NPM. package.json содержит удобные методы для работы с NPM, включая компиляцию, тесты и прочее.
Для запуска автоматической системы сборки и запуска нашей документации локально, вам понадобится копия исходников Bootstrap и Node:
- Установите Node, для управления зависимостями BS.
- Перейдите в директорию
/bootstrap
и запустите командуnpm install
для установки локальных зависимостей, перечисленных в package.json. - Установите 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:
- Смотрите «Установку инструментария» (выше) для инструкций по установке Jekyll («строитель» сайтов) и других зависимостей Ruby командой
bundle install
. - Запустите команду
npm run docs-serve
в CMD из корневой директории/bootstrap
. - Откройте
http://localhost:9001
в вашем браузере.
Узнайте больше про Jekyll здесь.
Отслеживание багов
Если возникнут проблемы с установкой зависимостей, удалите все предыдущие версии зависимостей (глобальные и локальные). Тогда попробуйте снова npm install
.