בניית כלים

למד כיצד להשתמש בתסריטי npm הכלולים של Bootstrap כדי לבנות את התיעוד שלנו, להדר קוד מקור, להריץ בדיקות ועוד.

הגדרת כלי עבודה

Bootstrap משתמש בסקריפטים של npm עבור מערכת הבנייה שלה. ה- package.json שלנו כולל שיטות נוחות לעבודה עם המסגרת, כולל קומפילציה של קוד, הפעלת בדיקות ועוד.

כדי להשתמש במערכת הבנייה שלנו ולהפעיל את התיעוד שלנו באופן מקומי, תזדקק לעותק של קובצי המקור והצומת של Bootstrap. בצע את השלבים הבאים ואתה אמור להיות מוכן לרוק:

1. הורד והתקן את Node.js , שבו אנו משתמשים כדי לנהל את התלות שלנו.
2. נווט אל ספריית השורש /bootstrapוהפעל npm installכדי להתקין את התלות המקומית שלנו הרשומה ב- package.json .
3. התקן את Ruby , התקן Bundler עם gem install bundlerולבסוף הפעל bundle install. פעולה זו תתקין את כל התלות של Ruby, כגון Jekyll ותוספים.
   • משתמשי Windows: קרא את המדריך הזה כדי להפעיל את Jekyll ללא בעיות.

לאחר השלמתו, תוכל להפעיל את הפקודות השונות שסופקו משורת הפקודה.

שימוש בסקריפטים של npm

package.json שלנו כולל את הפקודות והמשימות הבאות:

הפעל npm runכדי לראות את כל הסקריפטים של npm.

Autoprefixer

Bootstrap משתמש ב- Autoprefixer (כלול בתהליך הבנייה שלנו) כדי להוסיף אוטומטית קידומות של ספקים לחלק ממאפייני ה-CSS בזמן הבנייה. פעולה זו חוסכת לנו זמן וקוד בכך שהיא מאפשרת לנו לכתוב חלקים מרכזיים מה-CSS שלנו פעם אחת תוך ביטול הצורך במיקסינים של ספקים כמו אלה שנמצאים ב-v3.

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.