Инструменты сборки
Узнайте, как использовать запущенные скрипты npm для загрузки нашей документации, компиляции исходного кода, запуска тестов и т.п.
Установка инструментария
Bootstrap в своей автоматической системе сборки использует скрипты NPM. package.json содержит удобные методы для работы с NPM, включая компиляцию, тесты и прочее.
Для запуска автоматической системы сборки и запуска нашей документации локально, вам понадобится копия исходников Bootstrap и Node. Выполните следующие шаги:
- Установите Node, который мы используем для управления нашими зависимостями.
- Загрузите исходники Bootstrap или используйте репозиторий Bootstrap.
- Перейдите в корневой каталог
/bootstrap
и запустите командуnpm install
для установки локальных зависимостей, перечисленных в package.json.
По завершении вы сможете запускать различные команды из командной строки.
Использование скриптов NPM
Наш package.json включает в себя множество задач для разработки проекта. Запустите npm run
чтобы увидеть все скрипты npm в вашем терминале. Основные задачи включают в себя:
Задача | Описание |
---|---|
npm start
|
Компилирует CSS и JavaScript, создает документацию и запускает локальный сервер. |
npm run dist
|
Создает каталог dist/ со скомпилированными файлами. Требуются Sass, Autoprefixer и terser.
|
npm test
|
Запускает локальные тесты после запуска npm run dist
|
npm run docs-serve
|
Создает и запускает документацию локально. |
Автопрефиксер
Bootstrap использует Автопрефиксер (который участвует в процессе автоматической сборки) для автоматического добавления «вендорных префиксов» в некоторые свойства CSS во время процесса сборки. Это сберегает наше время, позволяя писать ключевые куски кода CSS один раз, и отменяя нужду в вендорных миксинах, в отличие от BS3.
Список браузеров, в которых есть поддержка автопрефиксера, здесь: .browserslistrc.
Локальная документация
Для локального запуска нашей документации требуется использовать Hugo, который устанавливается через пакет hugo-bin npm. Hugo - это невероятно быстрый и достаточно расширяемый генератор статических сайтов, который предоставляет нам базовые включения, файлы на основе Markdown, шаблоны и многое другое. Вот как это сделать:
- Выполните настройку инструментария, чтобы установить все зависимости.
- Из каталога root
/bootstrap
запуститеnpm run docs-serve
в командной строке. - Откройте
http://localhost:9001/
в вашем браузере.
Узнайте больше об использовании Hugo, прочитав документацию.
Отслеживание багов
Если возникнут проблемы с установкой зависимостей, удалите все предыдущие версии зависимостей (глобальные и локальные). После этого, повоторно выполните команду npm install
.