编译 Twitter bootstrap 3 文档（如何）？

Question

我正在尝试编译 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$ 

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

Answer 1

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

1. 安装 ruby​​gems (sudo apt-get install rubygems)
2. （须藤）gem install jekyll
3. 转到引导安装的./docs 目录（另请参阅：Explore and install 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/，而文档位于 docs.html 上见下文：

现在（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) 上测试这个命令

Answer 2

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

Answer 3

在 Windows 中（我完全测试了我不确定 linux）：

第 1 步：下载 Bootstrap3：github.com/twitter/bootstrap/archive/3.0.0-wip.zip
第二步：下载 Ruby：Click Here
Step3 : 下载 Devkit : Click Here 并解压到某个目录。
Step4 : 通过 ruby​​ 终端进入 devkit 目录并执行以下命令

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

版本步骤非常关键，因为我无法在最新版本的 jekyll 中编译文档，所以我切换到旧版本。

第 5 步：转到引导目录的根目录
第六步：运行 jekyll --server
Step7：在浏览器中访问 localhost:9001/ 或 localhost:4000/ （其中一个肯定可以工作）

Answer 4

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

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

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

1. 获取 Bootstrap 3 主 zip
   
   
2. 获取 Ruby 1.9.3
   
   
3. 获取 DevKit
   
   
4. 安装 Python 2.7 并使用 python 目录更新 PATH 环境变量
   
   

5. 获取 Jekyll 1.x，如 Bootstrap 的 GitHUb 页面中所述。
   
   通过 ruby​​ 终端进入 devkit 目录并执行以下命令

   ruby dk.rb 初始化
   ruby dk.rb 安装
   宝石安装 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 文件，因为您不会再使用它们来查看文档。

Answer 5

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

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

享受吧！

Answer 6

这里是完整的解决方案

要安装 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/

Answer 7

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/默认服务器网址