ابزار بسازید
بیاموزید که چگونه از اسکریپت های npm موجود در Bootstrap برای ساخت اسناد، کامپایل کد منبع، اجرای تست ها و موارد دیگر استفاده کنید.
بوت استرپ از اسکریپت های NPM برای سیستم ساخت خود استفاده می کند. package.json ما شامل روش‌های مناسب برای کار با چارچوب است، از جمله کامپایل کد، اجرای آزمایش‌ها و موارد دیگر.
برای استفاده از سیستم ساخت ما و اجرای مستندات ما به صورت محلی، به یک کپی از فایل های منبع بوت استرپ و Node نیاز دارید. این مراحل را دنبال کنید و باید آماده باشید:
- Node.js را دانلود و نصب کنید که از آن برای مدیریت وابستگی های خود استفاده می کنیم.
/bootstrapبه دایرکتوری ریشه بروید وnpm installبرای نصب وابستگی‌های محلی فهرست شده در package.json اجرا کنید .- Ruby را نصب کنید، باندلر را با نصب کنید
gem install bundlerو در نهایت اجراbundle installکنید. با این کار تمام وابستگی‌های Ruby مانند Jekyll و افزونه‌ها نصب می‌شود.- کاربران ویندوز: این راهنما را بخوانید تا جکیل بدون مشکل راه اندازی شود.
پس از تکمیل، می توانید دستورات مختلف ارائه شده از خط فرمان را اجرا کنید.
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 را از بین ببریم.
ما لیست مرورگرهای پشتیبانی شده از طریق Autoprefixer را در یک فایل جداگانه در مخزن GitHub خود نگهداری می کنیم. برای جزئیات به /package.json مراجعه کنید.
اجرای اسناد ما به صورت محلی نیاز به استفاده از Jekyll دارد، یک مولد سایت استاتیک با انعطاف پذیری مناسب که به ما ارائه می دهد: شامل موارد اساسی، فایل های مبتنی بر Markdown، قالب ها و موارد دیگر. در اینجا نحوه شروع آن آمده است:
- تنظیمات ابزار بالا را اجرا کنید تا Jekyll (سازنده سایت) و سایر وابستگی های Ruby را با
bundle install. /bootstrapاز دایرکتوری ریشه ،npm run docs-serveدر خط فرمان اجرا کنید.http://localhost:9001در مرورگر خود باز کنید و voilà.
با مطالعه مستندات آن درباره استفاده از Jekyll بیشتر بیاموزید .
اگر در نصب وابستگی ها با مشکل مواجه شدید، تمام نسخه های وابستگی قبلی (جهانی و محلی) را حذف نصب کنید. سپس، دوباره npm installاجرا کنید.