Source

اوزار بنائیں

ہمارے دستاویزات بنانے، سورس کوڈ کو مرتب کرنے، ٹیسٹ چلانے اور مزید بہت کچھ کرنے کے لیے بوٹسٹریپ کے شامل کردہ npm اسکرپٹس کو استعمال کرنے کا طریقہ سیکھیں۔

ٹولنگ سیٹ اپ

بوٹسٹریپ اپنے بلڈ سسٹم کے لیے NPM اسکرپٹ استعمال کرتا ہے۔ ہمارے package.json میں فریم ورک کے ساتھ کام کرنے کے لیے آسان طریقے شامل ہیں، بشمول کوڈ مرتب کرنا، ٹیسٹ چلانا، اور بہت کچھ۔

ہمارے بلڈ سسٹم کو استعمال کرنے اور ہماری دستاویزات کو مقامی طور پر چلانے کے لیے، آپ کو بوٹسٹریپ کی سورس فائلز اور نوڈ کی ایک کاپی درکار ہوگی۔ ان اقدامات پر عمل کریں اور آپ کو ہلانے کے لیے تیار ہونا چاہیے:

  1. ڈاؤن لوڈ اور انسٹال کریں Node.js ، جسے ہم اپنے انحصار کو منظم کرنے کے لیے استعمال کرتے ہیں۔
  2. روٹ /bootstrapڈائرکٹری پر جائیں اور پیکج. jsonnpm install میں درج ہماری مقامی انحصار کو انسٹال کرنے کے لیے چلائیں ۔
  3. روبی انسٹال کریں ، بنڈلر کے ساتھ انسٹال کریں gem install bundler، اور آخر میں چلائیں bundle install۔ یہ روبی کے تمام انحصار کو انسٹال کرے گا، جیسے جیکیل اور پلگ ان۔
    • ونڈوز صارفین: جیکیل کو بغیر کسی پریشانی کے چلانے کے لیے یہ گائیڈ پڑھیں ۔

مکمل ہونے پر، آپ کمانڈ لائن سے فراہم کردہ مختلف کمانڈز کو چلانے کے قابل ہو جائیں گے۔

NPM اسکرپٹس کا استعمال

ہمارے package.json میں درج ذیل کمانڈز اور کام شامل ہیں:

کام تفصیل
npm run dist npm run dist/distمرتب شدہ فائلوں کے ساتھ ڈائریکٹری بناتا ہے ۔ Sass , Autoprefixer , اور UglifyJS استعمال کرتا ہے ۔
npm test اس کے علاوہ یہ مقامی طور npm run distپر ٹیسٹ چلاتا ہے۔
npm run docs دستاویزات کے لیے CSS اور JavaScript بناتا ہے اور لِنٹ کرتا ہے۔ اس کے بعد آپ دستاویزات کو مقامی طور پر کے ذریعے چلا سکتے ہیں npm run docs-serve۔

تمام npm npm runاسکرپٹ دیکھنے کے لیے دوڑیں۔

آٹوپریفکسر

بوٹسٹریپ آٹوپریفکسر (ہمارے تعمیراتی عمل میں شامل ہے) کا استعمال کرتا ہے تاکہ خود بخود کچھ CSS خصوصیات میں وینڈر کے سابقے کو تعمیر کے وقت شامل کیا جا سکے۔ ایسا کرنے سے ہمارے وقت اور کوڈ کی بچت ہوتی ہے اور ہمیں اپنے CSS کے کلیدی حصوں کو ایک بار لکھنے کی اجازت دیتا ہے جبکہ v3 میں پائے جانے والے وینڈر مکسنس کی ضرورت کو ختم کر دیتا ہے۔

ہم اپنے GitHub ریپوزٹری کے اندر ایک علیحدہ فائل میں Autoprefixer کے ذریعے تعاون یافتہ براؤزرز کی فہرست کو برقرار رکھتے ہیں۔ تفصیلات کے لیے /package.json دیکھیں ۔

مقامی دستاویزات

ہماری دستاویزات کو مقامی طور پر چلانے کے لیے Jekyll کے استعمال کی ضرورت ہوتی ہے، جو کہ ایک باوقار لچکدار جامد سائٹ جنریٹر ہے جو ہمیں فراہم کرتا ہے: بنیادی شامل ہیں، مارک ڈاؤن پر مبنی فائلیں، ٹیمپلیٹس، اور بہت کچھ۔ اسے شروع کرنے کا طریقہ یہاں ہے:

  1. جیکیل (سائٹ بلڈر) اور دیگر روبی انحصار کو انسٹال کرنے کے لیے اوپر والے ٹولنگ سیٹ اپ کے ذریعے چلائیں bundle install۔
  2. روٹ /bootstrapڈائرکٹری سے، npm run docs-serveکمانڈ لائن میں چلائیں۔
  3. اپنے براؤزر میں کھولیں http://localhost:9001، اور voilà۔

Jekyll کے استعمال کے بارے میں مزید جانیں اس کی دستاویزات پڑھ کر ۔

خرابیوں کا سراغ لگانا

اگر آپ کو انحصار کو انسٹال کرنے میں دشواری کا سامنا کرنا پڑتا ہے تو، تمام پچھلے انحصار ورژن (عالمی اور مقامی) کو ان انسٹال کریں۔ پھر، دوبارہ چلائیں npm install.