構建工具

了解如何使用 Bootstrap 包含的 npm 腳本來構建我們的文檔、編譯源代碼、運行測試等。

工具設置

Bootstrap為其構建系統使用npm 腳本。我們的package.json包含使用框架的便捷方法，包括編譯代碼、運行測試等。

要使用我們的構建系統並在本地運行我們的文檔，您需要一份 Bootstrap 源文件和 Node.js 的副本。按照這些步驟，你應該準備好搖滾：

1. 下載並安裝 Node.js，我們用它來管理我們的依賴項。
2. 導航到根/bootstrap目錄並運行以安裝我們在package.jsonnpm install中列出的本地依賴項。
3. 安裝 Ruby，安裝Bundler，gem install bundler最後運行bundle install。這將安裝所有 Ruby 依賴項，例如 Jekyll 和插件。
   • Windows 用戶：閱讀本指南，讓 Jekyll 順利啟動並運行。

完成後，您將能夠運行命令行提供的各種命令。

使用 npm 腳本

我們的package.json包含以下命令和任務：

運行npm run以查看所有 npm 腳本。

自動前綴

Bootstrap 使用Autoprefixer（包含在我們的構建過程中）在構建時自動將供應商前綴添加到某些 CSS 屬性。這樣做可以讓我們一次性編寫 CSS 的關鍵部分，同時消除對 v3 中的供應商 mixin 的需求，從而節省了我們的時間和代碼。

我們在 GitHub 存儲庫中的單獨文件中維護通過 Autoprefixer 支持的瀏覽器列表。有關詳細信息，請參閱.browserslistrc。

本地文檔

在本地運行我們的文檔需要使用 Jekyll，這是一個相當靈活的靜態站點生成器，它為我們提供：基本包含、基於 Markdown 的文件、模板等。以下是如何開始：

1. 運行上面的工具設置以安裝 Jekyll（站點構建器）和其他 Ruby 依賴項bundle install。
2. 從根/bootstrap目錄，npm run docs-serve在命令行中運行。
3. http://localhost:9001在瀏覽器中打開，瞧。

通過閱讀 Jekyll 的文檔了解更多關於使用 Jekyll 的信息。

故障排除

如果您在安裝依賴項時遇到問題，請卸載所有以前的依賴項版本（全局和本地）。然後，重新運行npm install。