Source

أدوات البناء

تعرف على كيفية استخدام البرامج النصية npm المضمنة في Bootstrap لإنشاء وثائقنا ، وتجميع التعليمات البرمجية المصدر ، وتشغيل الاختبارات ، والمزيد.

إعداد الأدوات

يستخدم Bootstrap البرامج النصية NPM لنظام البناء الخاص به. تتضمن package.json طرقًا ملائمة للعمل مع إطار العمل ، بما في ذلك تجميع التعليمات البرمجية وتشغيل الاختبارات والمزيد.

لاستخدام نظام البناء الخاص بنا وتشغيل وثائقنا محليًا ، ستحتاج إلى نسخة من ملفات مصدر Bootstrap و Node. اتبع هذه الخطوات ويجب أن تكون مستعدًا لموسيقى الروك:

  1. قم بتنزيل وتثبيت Node.js ، والذي نستخدمه لإدارة تبعياتنا.
  2. انتقل إلى الدليل الجذر /bootstrapوقم بالتشغيل npm installلتثبيت التبعيات المحلية الخاصة بنا المدرجة في package.json .
  3. قم بتثبيت Ruby ، ​​وتثبيت Bundlergem install bundler ، ثم تشغيله أخيرًا bundle install. سيؤدي هذا إلى تثبيت جميع تبعيات Ruby ، ​​مثل Jekyll والإضافات.
    • مستخدمو Windows: اقرأ هذا الدليل للحصول على Jekyll وتشغيله دون مشاكل.

عند الانتهاء ، ستتمكن من تشغيل الأوامر المختلفة المتوفرة من سطر الأوامر.

استخدام البرامج النصية NPM

يتضمن 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 الخاص بنا. راجع /.browserslistrc للحصول على التفاصيل.

الوثائق المحلية

يتطلب تشغيل وثائقنا محليًا استخدام Jekyll ، وهو منشئ موقع ثابت مرن بشكل لائق يوفر لنا: التضمينات الأساسية ، والملفات المستندة إلى Markdown ، والقوالب ، والمزيد. إليك كيفية البدء:

  1. قم بتشغيل إعداد الأدوات أعلاه لتثبيت Jekyll (منشئ الموقع) وتبعيات روبي الأخرى باستخدام bundle install.
  2. من الدليل الجذر /bootstrap، قم بتشغيل npm run docs-serveسطر الأوامر.
  3. افتح http://localhost:9001في المتصفح الخاص بك ، وفويلا.

تعرف على المزيد حول استخدام Jekyll من خلال قراءة وثائقه .

استكشاف الأخطاء وإصلاحها

إذا واجهت مشاكل في تثبيت التبعيات ، فقم بإلغاء تثبيت جميع إصدارات التبعية السابقة (العالمية والمحلية). ثم أعد التشغيل npm install.