Компилировать документы Twitter bootstrap 3 (как это сделать)?

Я пытаюсь скомпилировать bootstrap 3. У меня есть репо, клонированное на моем локальном компьютере. Я запускаю make в каталоге начальной загрузки.

aaas-imac:bootstrap aaa$ make



Building Bootstrap...
--------------------------------------------------
Running JSHint on JavaScript...             ✔ Done
Compiling LESS with Recess...               ✔ Done
Prepping documentation assets...            ✔ Done
Compiling and minifying JavaScript...       ✔ Done
--------------------------------------------------
Success!

Thanks for using Bootstrap,
<3 @mdo and @fat

aaas-imac:bootstrap aaa$

Я нигде не вижу скомпилированные документы?


twitter-bootstrap makefile twitter-bootstrap-3
person Harry    schedule 10.03.2013    source источник
comment
Другой вариант загрузки форка документации: github.com/AAlakkad/Bootstrap-3-Offline -Документы   -  person John Magnolia    schedule 03.04.2014
comment
Работает на меня. Загрузите zip-файл, распакуйте все и укажите в браузере index.html. Легко.   -  person pete howard    schedule 30.04.2014

Ответы (7)


arrow_upward
11
arrow_downward

Документация Bootstrap 3.0 создается с использованием Jekyll. Чтобы просматривать документы локально, вам необходимо установить Jekyll для запуска локального сервера.

person Kisuka    schedule 10.03.2013
comment
Ссылка не ведет на документы. На странице есть только ссылка на выпуск Bootstrap 3 на гитхабе. - person Willem de Wit; 03.04.2013
comment
В то время, когда мой ответ был опубликован, он действительно указывал на размещенную копию документов Bootstrap 3. С тех пор они удалили его. Теперь вам нужно запустить локальный сервер Jekyll, чтобы получить документацию. - person Kisuka; 06.04.2013
comment
@ZainShaikh Я написал об этом пост: блог .greenmice.info/2013/04/ tl;dr; Джекил. /tmp/bootstrap3-docs/ ; компакт-диск /tmp/bootstrap3-docs; python -m Простой HTTP-сервер 8000 - person rvs; 21.04.2013
comment
Для интересующихся. Я собрал документы и разместил их по адресу bootstrap.harp.io. Я постараюсь сохранить их до тех пор, пока команда начальной загрузки не выведет их в сеть. - person sintaxi; 04.05.2013
comment
@sintaxi документы, похоже, устарели. Можно поделиться как собирали или обновляли до последней версии? Спасибо - person Diego Vieira; 01.11.2013

arrow_upward
14
arrow_downward

Чтобы установить Jekyll и собрать: (Примечание для окон см.: https://stackoverflow.com/a/16853614/1596547)

  1. установить rubygems (sudo apt-get install rubygems)
  2. (судо) gem install jekyll
  3. перейдите в каталог ./docs вашей установки начальной загрузки (см. также: Изучите и установите Twitter Bootstrap 3)
  4. запустите jekyll --server из вашего загрузочного каталога
  5. посетите http://localhost:9001/ http://localhost:9001/docs.html в браузере

NB порт по умолчанию для WEBrick будет 9001. Если этот порт недоступен, будет использоваться другой порт: WARN TCPServer Error: Address already in use - bind(2) INFO WEBrick::HTTPServer#start: pid=30728 port=4000

При посещении http://localhost:9001/ вы увидите главный экран. Кнопка "Просмотреть документы" указывает на /docs/, когда документы находятся на docs.html См. ниже:

Документация Twitter Bootstrap 3.0.0

Теперь (10 июля 2013 г.) ссылки на панели навигации кажутся неработающими (отсутствует .html), поэтому используйте http://localhost:9001/javascript.html вместо http://localhost:9001/javascript. См. также: https://github.com/twitter/bootstrap/pull/8443

Используя git (jekyll уже установлен):

git clone --branch 3.0.0-wip git://github.com/twitter/bootstrap.git
cd bootstrap
jekyll --server

посетите http://localhost:9001/ или http://localhost:4000/

ОБНОВЛЕНИЕ @lee-whitney предлагает использовать jekyll serve вместо jekyll --server. Команда jekyll serve создает каталог с html-файлами документов. Вы можете обслуживать эти файлы на (локальном) веб-сервере. jekyll serve не запускайте сервер (jekyll). Я тестирую эти команды на Linux (Ubuntu 12.04LTS) с Jekyll 0.12.1.

person Bass Jobsen    schedule 01.05.2013

arrow_upward
5
arrow_downward

В Windows (отлично проверено мной, не уверенным в Linux):

Шаг 1: Загрузите Bootstrap3: github.com/twitter/bootstrap/archive/3.0.0-wip.zip
Шаг 2: Загрузите Ruby: Нажмите здесь
Шаг 3: Загрузите Devkit: Нажмите здесь и извлеките его в какой-либо каталог.
Шаг 4. Перейдите в каталог devkit через терминал ruby ​​и выполнить следующие команды

ruby dk.rb init
ruby dk.rb install
gem install jekyll --version '= 0.11.0'

Шаг версии очень важен, так как мне не удалось скомпилировать документы в последней версии jekyll, поэтому я переключился на более старую версию.

Шаг 5: перейдите в корневой каталог вашего каталога начальной загрузки
Шаг 6: запустите jekyll --server
Шаг 7: посетите localhost:9001/ или localhost:4000/ в своем браузере (один из них обязательно сработает)

person Abhishek Goel    schedule 31.05.2013
comment
Спасибо. Шаг 5 устарел, команду сервера jekyll необходимо запускать из-под root. - person Diego Vieira; 01.11.2013
comment
Это было действительно полезно для среды Windows. - person DavidHyogo; 19.04.2014

arrow_upward
3
arrow_downward

Я попробовал метод Абхишека, и он сработал. Но не полностью. У меня все еще есть некоторые ошибки Fluid.

Поэтому я много копался и нашел решение. Компиляция Bootstrap 3 немного раздражает больше, чем 2.3.2

Сделайте следующее, чтобы скомпилировать и запустить его.

  1. Получите главный ZIP-файл Bootstrap 3

  2. Получить Ruby 1.9.3

  3. Получить DevKit

  4. Установите Python 2.7 и обновите переменную среды PATH, указав каталог python

  5. #P4# <блочная цитата> #P5#
  6. #P6# <блочная цитата> #P7#
  7. #P8# <блочная цитата> #P9#

Теперь перейдите на localhost:9001 и там вы должны увидеть документы, размещенные локально.

ПРИМЕЧАНИЕ. После компиляции вы можете получить доступ к этим страницам без необходимости каждый раз запускать команду jekyll serve. Просто откройте HTML-страницы, как любую локально сохраненную веб-страницу.

Кроме того, не стесняйтесь удалять извлеченные файлы DevKit, так как вы больше не будете использовать их для просмотра документации.

person Thoshi B    schedule 22.09.2013
comment
Вы, сэр, фантастические. Я некоторое время ломал голову над этим. +1 - person robabby; 09.10.2013
comment
Это проделало долгий путь, но последний шаг по постоянной компиляции файлов документов у меня не сработал. Я обнаружил, что мне нужно заходить в каталог начальной загрузки и запускать jekyll --server каждый раз, чтобы правильно просматривать документы. - person DavidHyogo; 19.04.2014

arrow_upward
1
arrow_downward

Вот сжатые документы, не нужно ничего делать, кроме как читать. Полная загружаемая документация по Bootstrap 3.

http://web3canvas.com/item/bootstrap-3-docs/

Наслаждаться!

person Alejandro Casanova    schedule 30.04.2014

arrow_upward
1
arrow_downward

Вот полное решение

Чтобы установить Jekyll, Rouge и собрать:

если у вас не установлен рубин - http://jekyll-windows.juthilo.com/2-jekyll-gem/

  1. из командной строки, перейдите в папку начальной загрузки
  2. выполнить npm install — если у вас возникнут проблемы, выполните npm update
  3. если jekyll не был установлен, запустите gem install jekyll
  4. затем запустите gem install rouge
  5. запустите jekyll server из папки начальной загрузки
  6. посетите http://localhost:9001/
person Charl Kruger    schedule 16.04.2015
comment
проверено 6 июля 2015 г., на данный момент вам нужны румяна, так что это правильный ответ - person Sabrina Leggett; 06.07.2015

arrow_upward
0
arrow_downward

Update: For Bootstrap version 3.3.4

Чтобы запустить документы Twitter Bootstrap(v3.3.4) локально, я выполнил следующие шаги и надеюсь, что это может помочь другим.

Шаги:

  • gem install jekyll (необходимо установить Ruby, Rubygems)

  • git clone --branch gh-pages git://github.com/twitter/bootstrap.git

    (теперь ветвь gh-pages содержит всю документацию)

  • cd bootstrap
  • jekyll serve
  • Посетите http://127.0.0.1:4000/ URL-адрес сервера по умолчанию
person brg    schedule 19.03.2015