Source

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

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

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

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

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

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

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

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

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

Задача Описание
npm run dist npm run distсоздает /dist/каталог с скомпилированными файлами. Использует Sass , Autoprefixer и UglifyJS .
npm test То же, что npm run distи плюс, запускает тесты локально
npm run docs Создает и анализирует CSS и JavaScript для документов. Затем вы можете запустить документацию локально через npm run docs-serve.

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

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

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

Мы храним список браузеров, поддерживаемых Autoprefixer, в отдельном файле в нашем репозитории GitHub. Подробности смотрите в .browserslistrc .

Местная документация

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

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

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

Исправление проблем

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