21

我正在尝试编译 bootstrap 3。我在本地克隆了 repo。我在引导目录中运行 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$

我在任何地方都看不到已编译的文档？

4

7 回答 7

14

要安装 Jekyll 并构建：（Windows 的注意事项参见：https ://stackoverflow.com/a/16853614/1596547 ）

  1. 安装 ruby​​gems (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在您的浏览器中访问

注意 WEBrick 的默认端口为 9001。如果此端口不可用，将使用其他端口：WARN TCPServer Error: Address already in use - bind(2) INFO WEBrick::HTTPServer#start: pid=30728 port=4000

当您访问时，http://localhost:9001/您会发现一个主屏幕。当文档位于 docs.html 时，“查看文档”按钮链接到 /docs/见下文：

Twitter 的 Bootstrap 3.0.0 文档

现在（2013 年 7 月 10 日）导航栏链接似乎已损坏（缺少 .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）服务器。我用 Jekyll 0.12.1 在 linux (Ubuntu 12.04LTS) 上测试这个命令

于 2013-05-01T12:45:29.313 回答
11

Bootstrap 3.0 的文档是使用Jekyll构建的。要在本地查看文档，您需要安装 Jekyll以运行本地服务器。

于 2013-03-10T12:23:30.213 回答
5

在 Windows 中（经过我对 linux 不确定的完美测试）：

Step1：下载Bootstrap3：github.com/twitter/bootstrap/archive/3.0.0-wip.zip
Step2：下载Ruby：点击这里
Step3：下载Devkit：点击这里并解压到某个目录。
Step4 : 通过 ruby​​ 终端进入 devkit 目录并执行以下命令

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/ （其中一个肯定可以工作）

于 2013-05-31T09:03:02.580 回答
3

我尝试了 Abhishek 的方法，它确实有效。但不完全。我仍然遇到一些流体错误。

所以我做了很多挖掘并找到了解决方案。编译 Bootstrap 3 比 2.3.2 更烦人

执行以下操作以编译并使其运行。

  1. 获取 Bootstrap 3 主 zip

  2. 获取 Ruby 1.9.3

  3. 获取 DevKit

  4. 安装 Python 2.7 并使用 python 目录更新 PATH 环境变量

  5. 获取 Bootstrap 的 GitHUb 页面上提到的 Jekyll 1.x。

    通过 ruby​​ 终端进入 devkit 目录并执行以下命令

    ruby dk.rb 初始化
    ruby​​ dk.rb 安装
    gem 安装jekyll

  6. 卸载 pygments 0.5.2 并安装 pygments 0.5.0

    gem 卸载 pygments.rb --version "=0.5.2"
    gem install pygments.rb --version "=0.5.0"

  7. 转到终端中提取的引导程序源的根目录并运行以下命令

    chcp 65001
    杰基尔发球

现在浏览到 localhost:9001 并在那里，您应该会看到本地托管的文档。

注意：编译后，您无需每次都运行 jekyll serve 命令即可访问这些页面。只需像打开任何本地保存的网页一样打开 html 页面。

此外，请随意删除提取的 DevKit 文件，因为您不会再次使用它们来查看文档。

于 2013-09-22T00:32:03.123 回答
1

这是压缩的文档，除了阅读之外不需要做任何事情。完整的可下载 Bootstrap 3 文档。

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

享受！

于 2014-04-30T15:24:01.667 回答
1

这是完整的解决方案

要安装 Jekyll、Rouge 并构建：

如果你没有安装 ruby​​ - http://jekyll-windows.juthilo.com/2-jekyll-gem/

  1. 从命令提示符，cd 进入您的引导文件夹
  2. 运行npm install- 如果遇到问题，请执行npm update
  3. 如果 jekyll 没有安装，运行gem install jekyll
  4. 然后运行gem install rouge
  5. jekyll server从您的引导文件夹运行
  6. 访问http://localhost:9001/
于 2015-04-16T14:12:27.853 回答
0

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
于 2015-03-19T11:31:56.917 回答