Source

Mbangun alat

Sinau carane nggunakake skrip npm sing kalebu Bootstrap kanggo mbangun dokumentasi, ngumpulake kode sumber, tes mbukak, lan liya-liyane.

Persiyapan perkakas

Bootstrap nggunakake skrip npm kanggo sistem mbangun. Package.json kita kalebu cara sing trep kanggo nggarap kerangka, kalebu kode kompilasi, tes sing mlaku, lan liya-liyane.

Kanggo nggunakake sistem mbangun lan mbukak dokumentasi lokal, sampeyan butuh salinan file sumber Bootstrap lan Node. Tindakake langkah iki lan sampeyan kudu siap kanggo rock:

  1. Ngundhuh lan nginstal Node.js , sing digunakake kanggo ngatur dependensi kita.
  2. /bootstrapNavigasi menyang direktori root lan mbukak npm installkanggo nginstal dependensi lokal sing kadhaptar ing package.json .
  3. Instal Ruby , nginstal Bundler karo gem install bundler, lan pungkasanipun mbukak bundle install. Iki bakal nginstal kabeh dependensi Ruby, kayata Jekyll lan plugins.
    • Pangguna Windows: Waca pandhuan iki supaya Jekyll bisa mlaku tanpa masalah.

Yen wis rampung, sampeyan bakal bisa mbukak macem-macem printah sing kasedhiya saka baris printah.

Nggunakake skrip npm

package.json kita kalebu printah lan tugas ing ngisor iki:

tugas Katrangan
npm run dist npm run distnggawe /dist/direktori karo file kompilasi. Migunakake Sass , Autoprefixer , lan UglifyJS .
npm test Padha npm run distplus iku mbukak tes lokal
npm run docs Mbangun lan lints CSS lan JavaScript kanggo docs. Sampeyan banjur bisa mbukak dokumentasi sacara lokal liwat npm run docs-serve.

Mbukak npm runkanggo ndeleng kabeh skrip npm.

Autoprefixer

Bootstrap nggunakake Autoprefixer (kalebu ing proses mbangun kita) kanggo nambahake awalan vendor kanthi otomatis menyang sawetara properti CSS nalika mbangun. Mengkono ngirit wektu lan kode kanthi ngidini kita nulis bagean-bagean penting saka CSS kita siji-sijine nalika ngilangi kabutuhan mixin vendor kaya sing ditemokake ing v3.

Kita njaga dhaptar browser sing didhukung liwat Autoprefixer ing file sing kapisah ing repositori GitHub. Waca .browserslistrc kanggo rincian.

Dokumentasi lokal

Nglakokake dokumentasi kita sacara lokal mbutuhake panggunaan Jekyll, generator situs statis sing fleksibel sing nyedhiyakake: dhasar kalebu, file basis Markdown, template, lan liya-liyane. Mangkene carane miwiti:

  1. Bukak persiyapan perkakas ing ndhuwur kanggo nginstal Jekyll (pembangun situs) lan dependensi Ruby liyane nganggo bundle install.
  2. /bootstrapSaka direktori root , mbukak npm run docs-serveing baris printah.
  3. Bukak http://localhost:9001ing browser sampeyan, lan voilà.

Sinau luwih lengkap babagan nggunakake Jekyll kanthi maca dokumentasi .

Ngatasi masalah

Yen sampeyan nemoni masalah nalika nginstal dependensi, instal kabeh versi dependensi sadurunge (global lan lokal). Banjur, mbukak maneh npm install.