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

Узнайте, как использовать включённые в Bootstrap npm-скрипты для сборки документации, компиляции исходного кода, запуска тестов и многого другого.

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

Bootstrap использует npm-скрипты для своей системы сборки. Наш package.json включает удобные методы для работы с фреймворком, включая компиляцию кода, запуск тестов и многое другое.

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

1. Скачайте и установите Node.js, которое мы используем для управления зависимостями.
2. Скачайте исходные файлы Bootstrap здесь или сделайте форк репозитория Bootstrap.
3. Перейдите в корневую /bootstrap директорию и выполните npm install, чтобы установить наши локальные зависимости, перечисленные в package.json.
4. Установите Ruby, установите Bundler с помощью gem install bundler, и, наконец, выполните bundle install. Это установит все Ruby-зависимости, такие как Jekyll и плагины.
   • Пользователи Windows: Прочитайте это руководство, чтобы без проблем запустить Jekyll.

По завершении вы сможете запускать различные команды из командной строки.

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

Наш package.json включает следующие команды и задачи:

Выполните npm run для просмотра всех npm-скриптов.

Autoprefixer

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.