Source

ابزار بسازید

بیاموزید که چگونه از اسکریپت های npm موجود در Bootstrap برای ساخت اسناد، کامپایل کد منبع، اجرای تست ها و موارد دیگر استفاده کنید.

راه اندازی ابزار

بوت استرپ از اسکریپت های npm برای سیستم ساخت خود استفاده می کند. package.json ما شامل روش‌های مناسب برای کار با چارچوب است، از جمله کامپایل کد، اجرای آزمایش‌ها و موارد دیگر.

برای استفاده از سیستم ساخت ما و اجرای مستندات ما به صورت محلی، به یک کپی از فایل های منبع بوت استرپ و Node نیاز دارید. این مراحل را دنبال کنید و باید آماده باشید:

  1. Node.js را دانلود و نصب کنید که از آن برای مدیریت وابستگی های خود استفاده می کنیم.
  2. /bootstrapبه دایرکتوری ریشه بروید و npm installبرای نصب وابستگی‌های محلی فهرست شده در package.json اجرا کنید .
  3. Ruby را نصب کنید، باندلر را با نصب کنید 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 و جاوا اسکریپت را برای اسناد می سازد و پر می کند. سپس می توانید اسناد را به صورت محلی از طریق اجرا npm run docs-serveکنید.

npm runبرای دیدن همه اسکریپت های npm اجرا کنید.

پیشوند خودکار

بوت استرپ از Autoprefixer (که در فرآیند ساخت ما گنجانده شده است) استفاده می کند تا به طور خودکار پیشوندهای فروشنده را به برخی از ویژگی های CSS در زمان ساخت اضافه کند. انجام این کار باعث صرفه‌جویی در زمان و کد می‌شود و به ما امکان می‌دهد بخش‌های کلیدی CSS خود را یکبار بنویسیم و در عین حال نیاز به میکس‌های فروشنده مانند موارد موجود در نسخه 3 را از بین ببریم.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See .browserslistrc for details.

Local documentation

Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  1. Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001 in your browser, and voilà.

Learn more about using Jekyll by reading its documentation.

Troubleshooting

اگر در نصب وابستگی ها با مشکل مواجه شدید، تمام نسخه های وابستگی قبلی (جهانی و محلی) را حذف نصب کنید. سپس، دوباره npm installاجرا کنید.