Source

Qurilish asboblari

Hujjatlarimizni yaratish, manba kodini kompilyatsiya qilish, testlarni ishga tushirish va boshqalar uchun Bootstrap-ga kiritilgan npm skriptlaridan qanday foydalanishni bilib oling.

Asboblarni sozlash

Bootstrap o'zining qurish tizimi uchun NPM skriptlaridan foydalanadi. Bizning package.json tizimida freymvork bilan ishlash uchun qulay usullar, jumladan kodni kompilyatsiya qilish, testlarni bajarish va boshqalar mavjud.

Qurilish tizimimizdan foydalanish va hujjatlarimizni mahalliy sifatida ishga tushirish uchun sizga Bootstrap manba fayllari va Node.ning nusxasi kerak bo‘ladi. Quyidagi bosqichlarni bajaring va siz siltanishga tayyor bo'lishingiz kerak:

  1. Node.js ni yuklab oling va o'rnating , biz bog'liqliklarimizni boshqarish uchun foydalanamiz.
  2. Ildiz /bootstrapkatalogiga o'ting va package.jsonnpm install ro'yxatida keltirilgan mahalliy bog'liqliklarimizni o'rnatish uchun ishga tushiring .
  3. Ruby o'rnating, Bundler bilan o'rnating gem install bundlerva nihoyat ishga tushiring bundle install. Bu Jekyll va plaginlar kabi barcha Ruby bog'liqliklarini o'rnatadi.
    • Windows foydalanuvchilari: Jekyll-ni muammosiz ishga tushirish uchun ushbu qo'llanmani o'qing .

Tugallangach, siz buyruq satridan taqdim etilgan turli buyruqlarni ishga tushirishingiz mumkin bo'ladi.

NPM skriptlaridan foydalanish

Bizning package.json quyidagi buyruqlar va vazifalarni o'z ichiga oladi:

Vazifa Tavsif
npm run dist npm run dist/distkompilyatsiya qilingan fayllar bilan katalog yaratadi . Sass , Autoprefixer va UglifyJS dan foydalanadi .
npm test Bundan npm run disttashqari, u mahalliy testlarni o'tkazadi
npm run docs Hujjatlar uchun CSS va JavaScript-ni yaratadi va lints qiladi. Shundan so'ng siz hujjatlarni mahalliy sifatida ishlatishingiz mumkin npm run docs-serve.

npm runBarcha npm skriptlarini ko'rish uchun ishga tushiring .

Avtoprefiksator

Bootstrap yaratish vaqtida ba'zi CSS xususiyatlariga avtomatik ravishda sotuvchi prefikslarini qo'shish uchun Autoprefixer (bizning qurish jarayoniga kiritilgan) dan foydalanadi. Bu bizga CSS-ning asosiy qismlarini bir marta yozishga imkon berib, vaqt va kodni tejaydi, shu bilan birga v3 da topilganlar kabi sotuvchi miksinlariga ehtiyoj qolmaydi.

Biz Autoprefixer orqali qo'llab-quvvatlanadigan brauzerlar ro'yxatini GitHub omborimizdagi alohida faylda saqlaymiz. Tafsilotlar uchun /package.json ga qarang .

Mahalliy hujjatlar

Hujjatlarimizni mahalliy sifatida ishga tushirish Jekyll-dan foydalanishni talab qiladi, bu bizga yaxshi moslashuvchan statik sayt generatori: asosiy o'z ichiga, Markdown-ga asoslangan fayllar, andozalar va boshqalarni taqdim etadi. Buni qanday boshlash kerak:

  1. Jekyll (sayt yaratuvchisi) va boshqa Ruby bog'liqliklarini o'rnatish uchun yuqoridagi asboblarnibundle install o'rnating .
  2. Ildiz /bootstrapkatalogidan npm run docs-servebuyruq satrida ishga tushiring.
  3. http://localhost:9001Brauzeringizda oching va voilà.

Jekyll-dan foydalanish haqida uning hujjatlarini o'qib chiqing .

Muammolarni bartaraf qilish; nosozliklarni TUZATISH

Agar bog'liqlikni o'rnatishda muammolarga duch kelsangiz, barcha oldingi qaramlik versiyalarini (global va mahalliy) o'chirib tashlang. Keyin, qayta ishga tushiring npm install.