in English

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

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

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

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

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

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

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

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

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

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

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

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

Bootstrap uses Autoprefixer (included in our build process) to automatically add vendor prefixes to some CSS properties at build time. Doing so saves us time and code by allowing us to write key parts of our CSS a single time while eliminating the need for vendor mixins like those found in 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. Поминете низ поставката за алатки погоре за да го инсталирате Jekyll (градителот на страницата) и други зависности на Ruby со bundle install.
  2. Од root /bootstrapдиректориумот, стартувајте npm run docs-serveво командната линија.
  3. Отворете http://localhost:9001во вашиот прелистувач и voilà.

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

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

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