Обзор Bootstrap, в том числе, как загрузить и использовать его, некоторые основные шаблоны и примеры, и многое другое.
Bootstrap использует Grunt его CSS и JavaScript система сборки и Jekyll для письменной документации. Наш Gruntfile включает в себя удобные методы для работы с фреймворк, в том числе компиляции кода, запуск тестов, и другое.
Чтобы использовать наши Gruntfile и запустить нашу документацию локально, вам понадобится копия Bootstrap источник файлов, узлом, и Grunt. Выполните следующие действия, и вы должны быть готовы:
grunt-cli
с npm install -g grunt-cli
./bootstrap
каталог и запустить npm install
Установить наши местные зависимостей, перечисленных в package.json.gem install bundler
, и, наконец, запустить bundle install
. Это позволит установить все Ruby зависимостей, таких как Jekyll и плагинов.
Когда он будет завершен, вы сможете запускать различные Grunt команд, предоставляемых из командной строки.
Наш Gruntfile включает в себя следующие команды и задачи:
Задача | Описание |
---|---|
grunt |
Запустить grunt , чтобы запустить тесты локально и скомпилировать CSS и JavaScript в /dist . Использует Sass, Autoprefixer и UglifyJS. |
grunt dist |
grunt dist создает /dist каталога скомпилированные файлы. Использует Sass, Autoprefixer и UglifyJS. |
grunt test |
Работает scss-lint, ESLint и QUnit тесты headlessly в PhantomJS (для ки). |
grunt docs |
Сборки и испытания CSS, JavaScript, и прочие активы, которые используются при выполнении документации на местном уровне через jekyll serve . |
grunt watch |
Это-метод удобства для просмотра всего Sass файлов и автоматически строя их всякий раз, когда вы сохраните. |
Bootstrap будет составлен с libsass по умолчанию, но вы можете выбрать в традиционном Ruby Sass Установка TWBS_SASS
переменной среды. Поддерживаются два варианта:
libsass
(по умолчанию), чтобы использовать libsass через grunt-sass.sass
использовать Ruby Sass через grunt-contrib-sass.К примеру, чтобы выполнять тестирование и сборку Bootstrap с помощью Ruby Sass введите TWBS_SASS=sass grunt
Bootstrap использует Autoprefixer (включен в наш Gruntfile и процесса сборки) для автоматического добавления вендорных префиксов для некоторых CSS свойства во время сборки. Это сэкономит нам время и код, позволяющий писать ключевые части нашей CSS один раз, тем самым устраняя необходимость миксины поставщика, как те, что в версии V3.
Мы поддерживаем список браузеров, поддерживаемых в рамках Autoprefixer в отдельный файл в нашем GitHub хранилище. Смотрите /grunt/postcss.js
для деталей.
Работает в нашей документации локально требует использования Jekyll, достаточно гибкий статический сайт генератор, который дает нам: Basic включает, по Уценке-файлы, шаблоны и многое другое. Вот как он начал:
bundle install
./bootstrap
, запустить bundle exec jekyll serve
в командной строке.Узнайте больше об использовании Jekyll, прочитав ее документация.
Если у вас возникнут проблемы с установкой зависимостей или работает Grunt команд, удалите все предыдущие версии зависимостей (глобальные и локальные). Запустите npm install
.