Source

Membina alatan

Ketahui cara menggunakan skrip npm yang disertakan Bootstrap untuk membina dokumentasi kami, menyusun kod sumber, menjalankan ujian dan banyak lagi.

Persediaan alatan

Bootstrap menggunakan skrip npm untuk sistem binaannya. Package.json kami termasuk kaedah mudah untuk bekerja dengan rangka kerja, termasuk menyusun kod, menjalankan ujian dan banyak lagi.

Untuk menggunakan sistem binaan kami dan menjalankan dokumentasi kami secara setempat, anda memerlukan salinan fail sumber Bootstrap dan Node. Ikuti langkah-langkah ini dan anda harus bersedia untuk menggegarkan:

  1. Muat turun dan pasang Node.js , yang kami gunakan untuk mengurus kebergantungan kami.
  2. Navigasi ke direktori akar /bootstrapdan jalankan npm installuntuk memasang kebergantungan setempat kami yang disenaraikan dalam package.json .
  3. Pasang Ruby , pasang Bundler dengan gem install bundler, dan akhirnya jalankan bundle install. Ini akan memasang semua kebergantungan Ruby, seperti Jekyll dan pemalam.
    • Pengguna Windows: Baca panduan ini untuk mengaktifkan dan menjalankan Jekyll tanpa masalah.

Apabila selesai, anda akan dapat menjalankan pelbagai arahan yang disediakan daripada baris arahan.

Menggunakan skrip npm

Package.json kami termasuk perintah dan tugas berikut:

Tugasan Penerangan
npm run dist npm run distmencipta /dist/direktori dengan fail yang disusun. Menggunakan Sass , Autoprefixer dan UglifyJS .
npm test Sama seperti npm run distplus, ia menjalankan ujian secara tempatan
npm run docs Membina dan menyelaraskan CSS dan JavaScript untuk dokumen. Anda kemudiannya boleh menjalankan dokumentasi secara setempat melalui npm run docs-serve.

Jalankan npm rununtuk melihat semua skrip npm.

Autoprefixer

Bootstrap menggunakan Autoprefixer (termasuk dalam proses binaan kami) untuk menambahkan awalan vendor secara automatik pada beberapa sifat CSS pada masa binaan. Melakukannya menjimatkan masa dan kod kami dengan membenarkan kami menulis bahagian penting CSS kami sekali gus sambil menghapuskan keperluan untuk campuran vendor seperti yang terdapat dalam v3.

Kami mengekalkan senarai penyemak imbas yang disokong melalui Autoprefixer dalam fail berasingan dalam repositori GitHub kami. Lihat .browserslistrc untuk butiran.

Dokumentasi tempatan

Menjalankan dokumentasi kami secara tempatan memerlukan penggunaan Jekyll, penjana tapak statik yang fleksibel yang memberikan kami: asas termasuk, fail berasaskan Markdown, templat dan banyak lagi. Berikut ialah cara untuk memulakannya:

  1. Jalankan melalui persediaan alatan di atas untuk memasang Jekyll (pembina tapak) dan kebergantungan Ruby lain dengan bundle install.
  2. Dari direktori akar /bootstrap, jalankan npm run docs-servedalam baris arahan.
  3. Buka http://localhost:9001dalam penyemak imbas anda, dan voilà.

Ketahui lebih lanjut tentang menggunakan Jekyll dengan membaca dokumentasinya .

Penyelesaian masalah

Sekiranya anda menghadapi masalah dengan memasang kebergantungan, nyahpasang semua versi kebergantungan sebelumnya (global dan tempatan). Kemudian, jalankan semula npm install.