Source

Membangun alat

Pelajari cara menggunakan skrip npm Bootstrap yang disertakan untuk membuat dokumentasi kami, mengkompilasi kode sumber, menjalankan pengujian, dan banyak lagi.

Pengaturan perkakas

Bootstrap menggunakan skrip NPM untuk sistem build-nya. Package.json kami menyertakan metode mudah untuk bekerja dengan framework, termasuk mengkompilasi kode, menjalankan tes, dan banyak lagi.

Untuk menggunakan sistem build kami dan menjalankan dokumentasi kami secara lokal, Anda memerlukan salinan file sumber Bootstrap dan Node.js. Ikuti langkah-langkah ini dan Anda harus siap untuk bergoyang:

  1. Unduh dan instal Node.js , yang kami gunakan untuk mengelola dependensi kami.
  2. Arahkan ke /bootstrapdirektori root dan jalankan npm installuntuk menginstal dependensi lokal kami yang terdaftar di package.json .
  3. Instal Ruby , instal Bundler dengan gem install bundler, dan akhirnya jalankan bundle install. Ini akan menginstal semua dependensi Ruby, seperti Jekyll dan plugin.
    • Pengguna Windows: Baca panduan ini untuk mengaktifkan dan menjalankan Jekyll tanpa masalah.

Setelah selesai, Anda akan dapat menjalankan berbagai perintah yang disediakan dari baris perintah.

Menggunakan skrip NPM

package.json kami menyertakan perintah dan tugas berikut:

Tugas Keterangan
npm run dist npm run distmembuat /distdirektori dengan file yang dikompilasi. Menggunakan Sass , Autoprefixer , dan UglifyJS .
npm test Sama seperti npm run distplus itu menjalankan tes secara lokal
npm run docs Membangun dan lints CSS dan JavaScript untuk dokumen. Anda kemudian dapat menjalankan dokumentasi secara lokal melalui npm run docs-serve.

Jalankan npm rununtuk melihat semua skrip npm.

Autoprefixer

Bootstrap menggunakan Autoprefixer (termasuk dalam proses pembuatan kami) untuk secara otomatis menambahkan awalan vendor ke beberapa properti CSS pada waktu pembuatan. Melakukannya menghemat waktu dan kode kami dengan memungkinkan kami untuk menulis bagian-bagian penting dari CSS kami satu kali sambil menghilangkan kebutuhan untuk mixin vendor seperti yang ditemukan di v3.

Kami menyimpan daftar browser yang didukung melalui Autoprefixer dalam file terpisah di dalam repositori GitHub kami. Lihat /package.json untuk detailnya.

Dokumentasi lokal

Menjalankan dokumentasi kami secara lokal memerlukan penggunaan Jekyll, generator situs statis fleksibel yang menyediakan kami: penyertaan dasar, file berbasis penurunan harga, templat, dan banyak lagi. Berikut cara memulainya:

  1. Jalankan melalui pengaturan perkakas di atas untuk menginstal Jekyll (pembuat situs) dan dependensi Ruby lainnya dengan bundle install.
  2. Dari direktori root /bootstrap, jalankan npm run docs-servedi baris perintah.
  3. Buka http://localhost:9001di browser Anda, dan voila.

Pelajari lebih lanjut tentang menggunakan Jekyll dengan membaca dokumentasinya .

Penyelesaian masalah

Jika Anda mengalami masalah dengan menginstal dependensi, hapus instalan semua versi dependensi sebelumnya (global dan lokal). Kemudian, jalankan kembali npm install.