أدوات البناء
تعرف على كيفية استخدام البرامج النصية npm المضمنة في Bootstrap لإنشاء وثائقنا ، وتجميع التعليمات البرمجية المصدر ، وتشغيل الاختبارات ، والمزيد.
يستخدم Bootstrap البرامج النصية NPM لنظام البناء الخاص به. تتضمن package.json طرقًا ملائمة للعمل مع إطار العمل ، بما في ذلك تجميع التعليمات البرمجية وتشغيل الاختبارات والمزيد.
لاستخدام نظام البناء الخاص بنا وتشغيل وثائقنا محليًا ، ستحتاج إلى نسخة من ملفات مصدر Bootstrap و Node. اتبع هذه الخطوات ويجب أن تكون مستعدًا لموسيقى الروك:
- قم بتنزيل وتثبيت Node.js ، والذي نستخدمه لإدارة تبعياتنا.
- انتقل إلى الدليل الجذر
/bootstrap
وقم بالتشغيلnpm install
لتثبيت التبعيات المحلية الخاصة بنا المدرجة في package.json . - قم بتثبيت Ruby ، وتثبيت Bundler
gem install bundler
، ثم تشغيله أخيرًاbundle install
. سيؤدي هذا إلى تثبيت جميع تبعيات Ruby ، مثل Jekyll والإضافات.- مستخدمو Windows: اقرأ هذا الدليل للحصول على Jekyll وتشغيله دون مشاكل.
عند الانتهاء ، ستتمكن من تشغيل الأوامر المختلفة المتوفرة من سطر الأوامر.
يتضمن package.json الأوامر والمهام التالية:
مهمة | وصف |
---|---|
npm run dist |
npm run dist ينشئ /dist الدليل مع الملفات المترجمة. يستخدم Sass و Autoprefixer و UglifyJS . |
npm test |
كما هو الحال npm run dist مع إجراء الاختبارات محليًا |
npm run docs |
ينشئ CSS وجافا سكريبت لـ docs. يمكنك بعد ذلك تشغيل الوثائق محليًا عبر npm run docs-serve . |
تشغيل npm run
لرؤية جميع البرامج النصية npm.
يستخدم Bootstrap Autoprefixer (مضمن في عملية الإنشاء الخاصة بنا) لإضافة بادئات البائع تلقائيًا إلى بعض خصائص CSS في وقت الإنشاء. يؤدي القيام بذلك إلى توفير الوقت والشفرة من خلال السماح لنا بكتابة الأجزاء الرئيسية من CSS الخاص بنا مرة واحدة مع التخلص من الحاجة إلى مزج البائعين مثل تلك الموجودة في الإصدار 3.
نحتفظ بقائمة المتصفحات المدعومة من خلال Autoprefixer في ملف منفصل داخل مستودع GitHub الخاص بنا. راجع /package.json للحصول على التفاصيل.
يتطلب تشغيل وثائقنا محليًا استخدام Jekyll ، وهو منشئ موقع ثابت مرن بشكل لائق يوفر لنا: التضمينات الأساسية ، والملفات المستندة إلى Markdown ، والقوالب ، والمزيد. إليك كيفية البدء:
- قم بتشغيل إعداد الأدوات أعلاه لتثبيت Jekyll (منشئ الموقع) وتبعيات روبي الأخرى باستخدام
bundle install
. - من الدليل الجذر
/bootstrap
، قم بتشغيلnpm run docs-serve
سطر الأوامر. - افتح
http://localhost:9001
في المتصفح الخاص بك ، وفويلا.
تعرف على المزيد حول استخدام Jekyll من خلال قراءة وثائقه .
إذا واجهت مشاكل في تثبيت التبعيات ، فقم بإلغاء تثبيت جميع إصدارات التبعية السابقة (العالمية والمحلية). ثم أعد التشغيل npm install
.