跳到主要內容 跳到文件導覽

使用我們的文件建置腳本和測試來協助開發 Bootstrap。

工具設定

Bootstrap 使用 npm 腳本 來建置文件和編譯原始檔。我們的 package.json 儲存這些腳本,用於編譯程式碼、執行測試等。這些腳本並非設計用於我們的儲存庫和文件之外。

若要使用我們的建置系統和在本地執行文件,您需要一份 Bootstrap 的原始檔和 Node。請按照下列步驟進行,您就能開始使用

  1. 下載並安裝 Node.js,我們用它來管理我們的相依性。
  2. 下載 Bootstrap 的原始碼 或分岔並複製 Bootstrap 的儲存庫
  3. 導覽至根目錄 /bootstrap 目錄並執行 npm install 來安裝我們在 package.json 中列出的本地相依性。

完成後,您將能夠從命令列執行提供的各種命令。

使用 npm 腳本

我們的 package.json 包含許多開發專案的任務。執行 npm run 以在您的終端機中查看所有 npm 腳本。主要任務包括:

任務 說明
npm start 編譯 CSS 和 JavaScript,建立文件,並啟動本機伺服器。
npm run dist 使用編譯檔案建立 dist/ 目錄。使用 SassAutoprefixerterser
npm test 在執行 npm run dist 後,在本地執行測試
npm run docs-serve 在本地建立並執行文件。
透過我們的入門專案使用 npm 開始使用 Bootstrap!前往 Sass & JS 範例 範本儲存庫,了解如何在自己的 npm 專案中建立並自訂 Bootstrap。包含 Sass 編譯器、Autoprefixer、Stylelint、PurgeCSS 和 Bootstrap 圖示。

Sass

Bootstrap 使用 Dart Sass 將我們的 Sass 原始檔編譯成 CSS 檔(包含在我們的建置流程中),如果您使用自己的資源管線編譯 Sass,我們建議您也這麼做。我們之前為 Bootstrap v4 使用 Node Sass,但 LibSass 和建立在其上的套件,包括 Node Sass,現在已 不建議使用

Dart Sass 使用 10 的捨入精度,且基於效率考量,不允許調整此值。我們不會在進一步處理所產生的 CSS(例如在縮小化期間)時降低此精度,但如果您選擇這樣做,我們建議維持至少 6 的精度,以防止瀏覽器捨入問題。

Autoprefixer

Bootstrap 使用 Autoprefixer(包含在我們的建置過程中)在建置時自動將供應商前綴新增至一些 CSS 屬性。這樣可以節省我們時間和程式碼,因為它允許我們一次撰寫 CSS 的主要部分,同時消除對 v3 中所見供應商混合的需求。

我們在 GitHub 儲存庫中的獨立檔案中維護 Autoprefixer 支援的瀏覽器清單。請參閱 .browserslistrc 以取得詳細資料。

RTLCSS

Bootstrap 使用 RTLCSS 處理已編譯的 CSS 並將其轉換為 RTL,基本上以其相反方向取代水平方向感知屬性(例如 padding-left)。它允許我們只撰寫一次 CSS,並使用 RTLCSS 控制 指令進行微調。

本地文件

在本地執行我們的文件需要使用 Hugo,它透過 hugo-bin npm 套件安裝。Hugo 是一個極為快速且可擴充的靜態網站產生器,它為我們提供:基本包含、基於 Markdown 的檔案、範本等等。以下是開始使用它的方法

  1. 執行上述 工具設定 以安裝所有相依性。
  2. 從根目錄 /bootstrap 目錄,在命令列中執行 npm run docs-serve
  3. 在瀏覽器中開啟 https://#:9001/,瞧。

閱讀 Hugo 的 文件,以深入了解如何使用 Hugo。

疑難排解

如果你在安裝相依項時遇到問題,請解除安裝所有先前版本的相依項(全域和本機)。然後,重新執行 npm install