Skip to main content

C чего начать

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

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

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

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

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

  1. Скачать и установить узел, которые мы используем, чтобы управлять нашими зависимостями.
  2. Установить Grunt инструментов командной строки grunt-cli с npm install -g grunt-cli.
  3. Перейдите в корневую /bootstrap каталог и запустить npm install Установить наши местные зависимостей, перечисленных в package.json.
  4. Установить Ruby установить Bundler с gem install bundler, и, наконец, запустить bundle install. Это позволит установить все Ruby зависимостей, таких как 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 тесты headlessly в PhantomJS (для ки).
grunt docs Сборки и испытания CSS, JavaScript, и прочие активы, которые используются при выполнении документации на местном уровне через jekyll serve.
grunt watch Это-метод удобства для просмотра всего Sass файлов и автоматически строя их всякий раз, когда вы сохраните.

Переключение Sass компиляторов

Bootstrap будет составлен с libsass по умолчанию, но вы можете выбрать в традиционном Ruby Sass Установка TWBS_SASS переменной среды. Поддерживаются два варианта:

Например, запустить TWBS_SASS=sass grunt для проверки и сборки Bootstrap и Ruby Sass.

Autoprefixer

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

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

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

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

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

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

Поиск и устранение неисправностей

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