Source

उपकरण बनाएं

हमारे दस्तावेज़ बनाने, स्रोत कोड संकलित करने, परीक्षण चलाने, और बहुत कुछ करने के लिए बूटस्ट्रैप की शामिल npm स्क्रिप्ट का उपयोग करना सीखें।

टूलींग सेटअप

बूटस्ट्रैप अपने बिल्ड सिस्टम के लिए npm स्क्रिप्ट का उपयोग करता है। हमारे package.json में फ्रेमवर्क के साथ काम करने के लिए सुविधाजनक तरीके शामिल हैं, जिसमें कोड संकलित करना, परीक्षण चलाना, और बहुत कुछ शामिल हैं।

हमारे बिल्ड सिस्टम का उपयोग करने और हमारे दस्तावेज़ों को स्थानीय रूप से चलाने के लिए, आपको बूटस्ट्रैप की स्रोत फ़ाइलों और Node. इन चरणों का पालन करें और आपको रॉक करने के लिए तैयार रहना चाहिए:

  1. Node.js डाउनलोड और इंस्टॉल करें , जिसका उपयोग हम अपनी निर्भरता को प्रबंधित करने के लिए करते हैं।
  2. रूट /bootstrapनिर्देशिका पर नेविगेट करें और package.jsonnpm install में सूचीबद्ध हमारी स्थानीय निर्भरता को स्थापित करने के लिए चलाएं ।
  3. रूबी स्थापित करें, बंडलर के साथ स्थापित करें gem install bundler, और अंत में चलाएं bundle install। यह सभी रूबी निर्भरताएं स्थापित करेगा, जैसे कि जेकिल और प्लगइन्स।
    • विंडोज उपयोगकर्ता: जेकिल को बिना किसी समस्या के चलाने और चलाने के लिए इस गाइड को पढ़ें ।

पूरा होने पर, आप कमांड लाइन से प्रदान की गई विभिन्न कमांड को चलाने में सक्षम होंगे।

एनपीएम स्क्रिप्ट का उपयोग करना

हमारे package.json में निम्नलिखित कमांड और कार्य शामिल हैं:

काम विवरण
npm run dist npm run dist/dist/संकलित फ़ाइलों के साथ निर्देशिका बनाता है । Sass , Autoprefixer , और UglifyJS का उपयोग करता है ।
npm test प्लस के समान ही npm run distयह स्थानीय स्तर पर परीक्षण चलाता है
npm run docs डॉक्स के लिए सीएसएस और जावास्क्रिप्ट बनाता है और लिंट करता है। फिर आप प्रलेखन को स्थानीय रूप से npm run docs-serve.

npm runसभी npm स्क्रिप्ट देखने के लिए दौड़ें ।

ऑटोप्रीफिक्सर

बूटस्ट्रैप ऑटोप्रिफ़िक्सर (हमारी निर्माण प्रक्रिया में शामिल) का उपयोग स्वचालित रूप से निर्माण समय पर कुछ सीएसएस गुणों में विक्रेता उपसर्ग जोड़ने के लिए करता है। ऐसा करने से हमें अपने सीएसएस के प्रमुख हिस्सों को एक बार लिखने की अनुमति देकर समय और कोड की बचत होती है, जबकि v3 में पाए जाने वाले वेंडर मिक्सिन की आवश्यकता समाप्त हो जाती है।

हम अपने GitHub रिपॉजिटरी के भीतर एक अलग फ़ाइल में Autoprefixer के माध्यम से समर्थित ब्राउज़रों की सूची बनाए रखते हैं। विवरण के लिए .browserslistrc देखें ।

स्थानीय दस्तावेज़ीकरण

हमारे दस्तावेज़ों को स्थानीय रूप से चलाने के लिए Jekyll के उपयोग की आवश्यकता होती है, जो एक शालीनता से लचीला स्थिर साइट जनरेटर है जो हमें प्रदान करता है: बुनियादी शामिल हैं, मार्कडाउन-आधारित फ़ाइलें, टेम्पलेट, और बहुत कुछ। इसे शुरू करने का तरीका यहां बताया गया है:

  1. Jekyll (साइट बिल्डर) और अन्य रूबी निर्भरता कोbundle install .
  2. रूट /bootstrapडायरेक्टरी से, npm run docs-serveकमांड लाइन में रन करें।
  3. http://localhost:9001अपने ब्राउज़र में खोलें , और आवाज करें।

इसके दस्तावेज़ों को पढ़कर जेकिल का उपयोग करने के बारे में और जानें ।

समस्या निवारण

यदि आपको निर्भरता स्थापित करने में समस्या आती है, तो सभी पिछले निर्भरता संस्करणों (वैश्विक और स्थानीय) की स्थापना रद्द करें। फिर, फिर से चलाएँ npm install