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

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

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

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

1. Установите Node, который мы используем для управления нашими зависимостями.
2. Загрузите исходники Bootstrap или используйте репозиторий Bootstrap.
3. Перейдите в корневой каталог /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, шаблоны и многое другое. Вот как это сделать:

1. Выполните настройку инструментария, чтобы установить все зависимости.
2. Из каталога root /bootstrap запустите npm run docs-serve в командной строке.
3. Откройте http://localhost:9001/ в вашем браузере.

Узнайте больше об использовании Hugo, прочитав документацию.

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

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