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

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

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

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

Содержание

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

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

  1. Скачайте и установите Node, который мы используем для управления нашими зависимостями.
  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 тесты в 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, шаблоны и многое другое. Чтобы начать работу, выполните следующие действия:

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

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

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

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

Комментарии

На сайте функционирует система проверки ошибок. Обнаружив неточность в тексте, выделите ее и нажмите Ctrl + Enter.

Поддержать проект

x