Начало работы

Обзор Bootstrap, включая загрузку и использование, некоторые основные шаблоны и примеры и многое другое.

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

Bootstrap использует Grunt для своей системы сборки CSS и JavaScript и Jekyll для письменной документации. Наш Gruntfile включает в себя удобные методы работы с фреймворком, включая компиляцию кода, запуск тестов и многое другое.

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

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

Скачайте и установите Node, который мы используем для управления нашими зависимостями.
Установите инструменты командной строки Grunt, grunt-cli с npm install -g grunt-cli.
Перейдите в каталог /bootstrap и запустите npm install, чтобы установить наши локальные зависимости, перечисленные в package.json.
Установите Ruby, установите Bundler с gem install bundler, и, наконец, запустите bundle install. Это установит все зависимости Ruby, такие как Jekyll и плагины.
- Пользователи Windows: прочитайте это неофициальное руководство, чтобы запустить Jekyll без проблем.

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

Использование Grunt

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

Задача	Описание
`grunt`	Запустите `grunt`, чтобы выполнить тесты локально и скомпилируйте CSS и JavaScript в `/dist`. Использует Sass, Autoprefixer, и UglifyJS.
`grunt dist`	`grunt dist` создает каталог `/dist` со скомпилированными файлами. Использует Sass, Autoprefixer, и UglifyJS.
`grunt test`	Запускает scss-lint, ESLint и QUnit тесты в PhantomJS (используется для CI).
`grunt docs`	Строит и тестирует CSS, JavaScript и другие ресурсы, которые используются при выполнении документации локально через `jekyll serve`.
`grunt watch`	Это удобный метод для просмотра файлов Sass и автоматического создания их при каждом сохранении.

Autoprefixer

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

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

Локальная документация

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

Пройдите настройку инструментов выше, чтобы установить Jekyll (компоновщик сайта) и другие зависимости Ruby с bundle install.
В корневом каталоге /bootstrap запустите команду bundle exec jekyll serve в командной строке.
Откройте https://localhost:9001 в своем браузере, и вуаля.

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

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

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