Source

साधने तयार करा

आमचे दस्तऐवज तयार करण्यासाठी, स्त्रोत कोड संकलित करण्यासाठी, चाचण्या चालवण्यासाठी आणि बरेच काही करण्यासाठी बूटस्ट्रॅपच्या समाविष्ट केलेल्या npm स्क्रिप्ट्सचा वापर कसा करावा ते शिका.

टूलिंग सेटअप

बूटस्ट्रॅप त्याच्या बिल्ड सिस्टमसाठी NPM स्क्रिप्ट वापरतो. आमच्या package.json मध्ये फ्रेमवर्कसह कार्य करण्यासाठी सोयीस्कर पद्धती समाविष्ट आहेत, ज्यामध्ये कोड संकलित करणे, चाचण्या चालवणे आणि बरेच काही समाविष्ट आहे.

आमची बिल्ड सिस्टम वापरण्यासाठी आणि आमचे दस्तऐवज स्थानिक पातळीवर चालवण्यासाठी, तुम्हाला बूटस्ट्रॅपच्या स्त्रोत फाइल्स आणि नोडची एक प्रत आवश्यक असेल. या चरणांचे अनुसरण करा आणि तुम्ही रॉक करण्यासाठी तयार असाल:

  1. Node.js डाउनलोड आणि स्थापित करा , जे आम्ही आमच्या अवलंबित्व व्यवस्थापित करण्यासाठी वापरतो.
  2. /bootstrapरूट निर्देशिकेवर नेव्हिगेट करा आणि package.jsonnpm install मध्ये सूचीबद्ध केलेले आमचे स्थानिक अवलंबन स्थापित करण्यासाठी चालवा .
  3. रुबी स्थापित करा , बंडलरसहgem install bundler स्थापित करा आणि शेवटी चालवा bundle install. हे सर्व Ruby अवलंबित्व स्थापित करेल, जसे की Jekyll आणि प्लगइन.
    • विंडोज वापरकर्ते: जेकिलला समस्यांशिवाय आणि चालू ठेवण्यासाठी हे मार्गदर्शक वाचा .

पूर्ण झाल्यावर, तुम्ही कमांड लाइनवरून प्रदान केलेल्या विविध कमांड्स चालविण्यात सक्षम व्हाल.

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 runस्क्रिप्ट पाहण्यासाठी धावा.

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

बूटस्ट्रॅप ऑटोप्रीफिक्सर (आमच्या बिल्ड प्रक्रियेमध्ये समाविष्ट) वापरते जे बिल्ड वेळेवर काही CSS गुणधर्मांमध्ये स्वयंचलितपणे विक्रेता उपसर्ग जोडण्यासाठी. असे केल्याने आम्हाला आमच्या CSS चे मुख्य भाग एकाच वेळी लिहिण्याची परवानगी देऊन वेळ आणि कोड वाचतो आणि v3 मध्ये आढळलेल्या विक्रेत्या मिक्सिनची गरज नाहीशी होते.

आम्ही आमच्या GitHub रेपॉजिटरीमध्ये एका वेगळ्या फाईलमध्ये Autoprefixer द्वारे समर्थित ब्राउझरची सूची राखतो. तपशीलांसाठी /.browserslistrc पहा.

स्थानिक दस्तऐवजीकरण

आमचे दस्तऐवज स्थानिक पातळीवर चालवण्यासाठी Jekyll चा वापर करणे आवश्यक आहे, एक सभ्यपणे लवचिक स्थिर साइट जनरेटर जे आम्हाला प्रदान करते: मूलभूत समावेश, मार्कडाउन-आधारित फाइल्स, टेम्पलेट्स आणि बरेच काही. ते कसे सुरू करायचे ते येथे आहे:

  1. जेकिल (साइट बिल्डर) आणि इतर रुबी अवलंबित्व स्थापित करण्यासाठी वरील टूलिंग सेटअपद्वारे चालवा bundle install.
  2. रूट /bootstrapनिर्देशिकेतून, npm run docs-serveकमांड लाइनमध्ये चालवा.
  3. http://localhost:9001तुमच्या ब्राउझरमध्ये उघडा आणि व्हॉइला.

जेकिल वापरण्याबद्दल त्याचे दस्तऐवजीकरण वाचून अधिक जाणून घ्या .

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

अवलंबन स्थापित करताना तुम्हाला समस्या आल्यास, सर्व मागील अवलंबन आवृत्त्या (जागतिक आणि स्थानिक) विस्थापित करा. मग, पुन्हा चालवा npm install.