Source

Ngawangun parabot

Diajar kumaha ngagunakeun skrip npm kalebet Bootstrap pikeun ngawangun dokuméntasi kami, nyusun kode sumber, ngajalankeun tés, sareng seueur deui.

Setélan pakakas

Bootstrap nganggo skrip npm pikeun sistem ngawangunna. package.json kami ngawengku métode merenah pikeun gawé bareng kerangka, kaasup kode compiling, ngajalankeun tés, sareng nu sanesna.

Pikeun nganggo sistem ngawangun kami sareng ngajalankeun dokuméntasi kami sacara lokal, anjeun peryogi salinan file sumber Bootstrap sareng Node. Turutan léngkah-léngkah ieu sareng anjeun kedah siap ngagulung:

  1. Ngundeur tur masang Node.js , nu urang pake pikeun ngatur kagumantungan urang.
  2. /bootstrapNapigasi ka diréktori root tur ngajalankeun npm installmasang dependensi lokal urang didaptarkeun di package.json .
  3. Install Ruby , install Bundler kalawan gem install bundler, sarta tungtungna ngajalankeun bundle install. Ieu bakal masang sadaya kagumantungan Ruby, sapertos Jekyll sareng plugins.
    • Pamaké Windows: Baca pituduh ieu pikeun ngajalankeun Jekyll tanpa masalah.

Nalika réngsé, anjeun bakal tiasa ngajalankeun rupa-rupa paréntah anu disayogikeun tina garis paréntah.

Ngagunakeun skrip npm

package.json kami kalebet paréntah sareng tugas di handap ieu:

Tugas Katerangan
npm run dist npm run distnyiptakeun /dist/diréktori sareng file anu disusun. Nganggo Sass , Autoprefixer , sareng UglifyJS .
npm test Sarua sareng npm run distplus éta ngajalankeun tés sacara lokal
npm run docs Ngawangun jeung lints CSS jeung JavaScript pikeun docs. Anjeun teras tiasa ngajalankeun dokuméntasi sacara lokal via npm run docs-serve.

Jalankeun npm runpikeun ningali sadaya skrip npm.

Autoprefixer

Bootstrap ngagunakeun Autoprefixer (kaasup dina prosés ngawangun kami) pikeun otomatis nambahkeun awalan vendor kana sababaraha sipat CSS dina waktu ngawangun. Ngalakukeun kitu ngahemat waktos sareng kode kami ku ngamungkinkeun urang nyerat bagian konci CSS kami sakaligus bari ngaleungitkeun kabutuhan mixin vendor sapertos anu aya dina v3.

Kami ngajaga daptar browser anu dirojong ku Autoprefixer dina file anu misah dina gudang GitHub kami. Tempo .browserslistrc pikeun detil.

Dokuméntasi lokal

Ngajalankeun dokuméntasi urang sacara lokal merlukeun pamakéan Jekyll, generator situs statik decently fléksibel nu nyadiakeun kami: dasar ngawengku, file basis Markdown, template, sarta leuwih. Ieu kumaha carana ngamimitian:

  1. Jalankeun setelan alat di luhur pikeun masang Jekyll (pembina situs) sareng katergantungan Ruby anu sanés nganggo bundle install.
  2. /bootstrapTina diréktori akar , jalankeun npm run docs-servedina garis paréntah.
  3. Buka http://localhost:9001dina panyungsi anjeun, sarta voilà.

Diajar langkung seueur ngeunaan ngagunakeun Jekyll ku maca dokuméntasina .

Pamérésan masalah

Upami anjeun ngalaman masalah sareng masang dependensi, cabut sadaya versi kagumantungan saméméhna (global sareng lokal). Lajeng, ngajalankeun deui npm install.