Source

Изградете алатки

Научете како да ги користите вклучените npm скрипти на Bootstrap за да ја изградите нашата документација, да компајлирате изворен код, да извршите тестови и многу повеќе.

Поставување алат

Bootstrap користи npm скрипти за својот систем за градење. Нашиот package.json вклучува практични методи за работа со рамката, вклучувајќи компајлирање код, извршување тестови и многу повеќе.

За да го користите нашиот систем за изградба и да ја извршувате нашата документација локално, ќе ви треба копија од изворните датотеки на Bootstrap и Node. Следете ги овие чекори и треба да бидете подготвени да се лулате:

  1. Преземете и инсталирајте Node.js , што го користиме за да управуваме со нашите зависности.
  2. Одете до root /bootstrapдиректориумот и стартувајте npm installза да ги инсталирате нашите локални зависности наведени во package.json .
  3. Инсталирајте Ruby , инсталирајте го Bundler со gem install bundler, и на крајот стартувајте bundle install. Ова ќе ги инсталира сите зависности на Ruby, како што се Jekyll и приклучоците.
    • Корисници на Windows: прочитајте го ова упатство за да го активирате Џекил без проблеми.

Кога ќе завршите, ќе можете да ги извршите различните команди обезбедени од командната линија.

Користење на скрипти npm

Нашиот package.json ги вклучува следните команди и задачи:

Задача Опис
npm run dist npm run distго креира /dist/директориумот со компајлирани датотеки. Користи Sass , Autoprefixer и UglifyJS .
npm test Исто како npm run distи плус тоа ги извршува тестовите локално
npm run docs Изградува и обложува CSS и JavaScript за документи. Потоа можете да ја извршите документацијата локално преку npm run docs-serve.

Стартувај npm runза да ги видиш сите скрипти npm.

Автоматски префиксатор

Bootstrap користи Autoprefixer (вклучен во нашиот процес на градење) за автоматско додавање префикси на продавач на некои CSS својства во времето на изградбата. Тоа ни заштедува време и код со тоа што ни дозволува да пишуваме клучни делови од нашиот CSS еднократно додека ја елиминираме потребата за мешавини на продавачи како оние што се наоѓаат во v3.

Списокот на прелистувачи поддржани преку Autoprefixer го одржуваме во посебна датотека во нашето складиште на GitHub. Видете .browserslistrc за детали.

Локална документација

Локално водење на нашата документација бара употреба на Jekyll, пристојно флексибилен генератор на статички локации што ни обезбедува: основни вклучува, датотеки базирани на Markdown, шаблони и многу повеќе. Еве како да го започнете:

  1. Поминете низ поставката за алатки погоре за да го инсталирате Jekyll (градителот на страницата) и други зависности на Ruby со bundle install.
  2. Од root /bootstrapдиректориумот, стартувајте npm run docs-serveво командната линија.
  3. Отворете http://localhost:9001во вашиот прелистувач и voilà.

Дознајте повеќе за користењето на Jekyll со читање на неговата документација .

Решавање проблеми

Доколку наидете на проблеми со инсталирање на зависности, деинсталирајте ги сите претходни верзии на зависности (глобални и локални). Потоа, повторувајте npm install.