编译Twitter bootstrap 3文档(如何)?

时间:2013-03-10 04:41:20

标签: twitter-bootstrap makefile twitter-bootstrap-3

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

我没有在任何地方看到编译过的文档?

7 个答案:

答案 0 :(得分:14)

安装Jekyll并构建:(注意窗口见:https://stackoverflow.com/a/16853614/1596547

  1. 安装rubygems(sudo apt-get install rubygems
  2. (sudo)gem install jekyll
  3. 转到引导程序安装的./docs目录(另请参阅:Explore and install Twitter Bootstrap 3
  4. 从你的bootstrap目录运行jekyll --server
  5. 在浏览器中访问http://localhost:9001/ http://localhost:9001/docs.html
  6. 注意,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's Bootstrap 3.0.0 Docs

    现在(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 --serverjekyll serve命令使用docs的html文件创建一个目录。您可以在(本地)Web服务器上提供此文件。 jekyll serve不启动(jekyll)服务器。我使用Jekyll 0.12.1

    在linux(Ubuntu 12.04LTS)上测试这些命令

答案 1 :(得分:11)

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

答案 2 :(得分:5)

在Windows中(完全由我测试,不确定linux):

  

步骤1:下载Bootstrap3:github.com/twitter/bootstrap/archive/3.0.0-wip.zip
  第二步:下载Ruby:Click Here
  步骤3:下载Devkit:Click Here并将其解压缩到某个目录   步骤4:通过ruby终端转到devkit direcory并执行以下命令

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

版本步骤非常重要,因为我无法在最新版本的jekyll中编译文档,因此我切换到旧版本。

  

步骤5:转到bootstrap目录的根目录
  Step6:运行jekyll --server
  Step7:在你的浏览器中访问localhost:9001 /或localhost:4000 /(其中一个肯定会工作)

答案 3 :(得分:3)

我尝试了Abhishek的方法,但确实有效。但不完全。我还有一些流体错误。

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

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

  1. 获取Bootstrap 3 master 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 init
      ruby dk.rb安装
      gem install jekyll

  6. 卸载pygments 0.5.2并安装pygments 0.5.0

      

    gem uninstall pygments.rb --version“= 0.5.2”
      gem install pygments.rb --version“= 0.5.0”

  7. 转到终端中解压缩的bootstrap源的根目录,然后运行以下

      

    chcp 65001
      杰基尔服务

  8. 现在浏览到localhost:9001,在那里,您应该看到本地托管的文档。

      

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

         

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

答案 4 :(得分:1)

以下是压缩文档,除了阅读之外无需做任何事情。完全可下载的Bootstrap 3文档。

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

享受!

答案 5 :(得分:1)

这是完整的解决方案

安装Jekyll,Rouge和build:

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

  1. 从comand promt,cd进入你的bootstrap文件夹
  2. 运行npm install - 如果遇到问题,请执行npm update
  3. 如果未安装jekyll,请运行gem install jekyll
  4. 然后运行gem install rouge
  5. 从您的bootstrap文件夹
  6. 运行jekyll server
  7. 访问http://localhost:9001/

答案 6 :(得分:0)

Update: For Bootstrap version 3.3.4

要在本地运行Twitter Bootstrap(v3.3.4)个文档,我执行了以下步骤,并希望它可以帮助其他人。

<强>步骤:

  • gem install jekyll(需要安装RubyRubygems
  • git clone --branch gh-pages git://github.com/twitter/bootstrap.git

    (现在gh-pages分支包含所有文档内容)

  • cd bootstrap
  • jekyll serve
  • 访问http://127.0.0.1:4000/默认服务器网址