Bootstrap 使用 Grunt 做爲編譯系統,而且對外提供了一些方便的方法用於編譯整個框架。下面講解的就是如何編譯源碼、運行測試用例等內容。
安裝 Grunt
安裝 Grunt 前,你須要首先下載並安裝
node.js
(npm 已經包含在內)。npm 是 node packaged modules 的簡稱,它的做用是基於 node.js 管理擴展包之間的依賴關係。
而後在命令行中輸入如下命令:
在全局環境中安裝 grunt-cli :npm install -g grunt-cli 。
使用淘寶鏡像
vi.npmrc
registry=https://registry.npm.taobao.org
sudo npm install -g grunt-cli
有時報grunt沒安裝成功,試試下面命令
sudo npm install grunt --save-dev
進入 /bootstrap/ 根目錄,而後執行 npm install 命令。npm 將讀取 package.json 文件並自動安裝此文件中列出的全部被依賴的擴展包。
上述步驟完成後,你就能夠運行 Bootstrap 所提供的各個 Grunt 命令了。
sudo npm install 實際中會報一些module不存在
>> Local Npm module 「grunt-contrib-qunit」 not found. Is it installed?
>> Local Npm module 「grunt-saucelabs」 not found. Is it installed?
執行如下命令進行安裝如下
sudo npm install grunt-contrib-qunit –save
sudo npm install grunt-saucelabs –save
可用的 Grunt 命令
grunt dist (僅編譯 CSS 和 JavaScript 文件)
從新生成 /dist/ 目錄,並將編譯壓縮後的 CSS 和 JavaScript 文件放入這個目錄中。做爲一名 Bootstrap 用戶,大部分狀況下你只須要執行這一個命令。
grunt watch (監測文件的改變,並運行指定的 Grunt 任務)
監測 Less 源碼文件的改變,並自動從新將其編譯爲 CSS 文件。
grunt test (運行測試用例)
在 PhantomJS 環境中運行 JSHint 和 QUnit 自動化測試用例。
grunt docs (Build & test the docs assets)
Builds and tests CSS, JavaScript, and other assets which are used when running the documentation locally via jekyll serve.
grunt (從新構建全部內容並運行測試用例)
編譯並壓縮 CSS 和 JavaScript 文件、構建文檔站點、對文檔作 HTML5 校驗、從新生成定製工具所需的資源文件等,都須要 Jekyll 工具。這些只有在你對 Bootstrap 深度研究時纔有用。
除錯
若是你在安裝依賴包或者運行 Grunt 命令時遇到了問題,請首先刪除 npm 自動生成的 /node_modules/ 目錄,而後,再次運行 npm install 命令。