使用我們的文件建置腳本和測試來協助開發 Bootstrap。
工具設定
Bootstrap 使用 npm 腳本 來建置文件和編譯原始檔。我們的 package.json 儲存這些腳本,用於編譯程式碼、執行測試等。這些腳本並非設計用於我們的儲存庫和文件之外。
若要使用我們的建置系統和在本地執行文件,您需要一份 Bootstrap 的原始檔和 Node。請按照下列步驟進行,您就能開始使用
- 下載並安裝 Node.js,我們用它來管理我們的相依性。
- 下載 Bootstrap 的原始碼 或分岔並複製 Bootstrap 的儲存庫。
- 導覽至根目錄
/bootstrap
目錄並執行npm install
來安裝我們在 package.json 中列出的本地相依性。
完成後,您將能夠從命令列執行提供的各種命令。
使用 npm 腳本
我們的 package.json 包含許多開發專案的任務。執行 npm run
以在您的終端機中查看所有 npm 腳本。主要任務包括:
任務 | 說明 |
---|---|
npm start |
編譯 CSS 和 JavaScript,建立文件,並啟動本機伺服器。 |
npm run dist |
使用編譯檔案建立 dist/ 目錄。使用 Sass、Autoprefixer 和 terser。 |
npm test |
在執行 npm run dist 後,在本地執行測試 |
npm run docs-serve |
在本地建立並執行文件。 |
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 的檔案、範本等等。以下是開始使用它的方法
- 執行上述 工具設定 以安裝所有相依性。
- 從根目錄
/bootstrap
目錄,在命令列中執行npm run docs-serve
。 - 在瀏覽器中開啟
https://#:9001/
,瞧。
閱讀 Hugo 的 文件,以深入了解如何使用 Hugo。
疑難排解
如果你在安裝相依項時遇到問題,請解除安裝所有先前版本的相依項(全域和本機)。然後,重新執行 npm install
。