Source

Алати за прављење

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

Подешавање алата

Боотстрап користи нпм скрипте за свој систем изградње. Наш пацкаге.јсон укључује згодне методе за рад са оквиром, укључујући компајлирање кода, покретање тестова и још много тога.

Да бисте користили наш систем изградње и локално покренули нашу документацију, требаће вам копија изворних датотека Боотстрапа и Ноде. Следите ове кораке и требало би да будете спремни за љуљање:

  1. Преузмите и инсталирајте Ноде.јс , који користимо за управљање нашим зависностима.
  2. Идите до основног /bootstrapдиректоријума и покрените npm installда инсталирате наше локалне зависности наведене у пацкаге.јсон .
  3. Инсталирајте Руби , инсталирајте Бундлер са gem install bundler, и на крају покрените bundle install. Ово ће инсталирати све Руби зависности, као што су Јекилл и додаци.
    • Корисници Виндовс-а: Прочитајте овај водич да бисте покренули Јекилл без проблема.

Када завршите, моћи ћете да покренете различите команде које сте добили из командне линије.

Коришћење нпм скрипти

Наш пацкаге.јсон укључује следеће команде и задатке:

Задатак Опис
npm run dist npm run distкреира /dist/директоријум са компајлираним датотекама. Користи Сасс , Аутопрефикер и УглифиЈС .
npm test Исто као npm run distплус покреће тестове локално
npm run docs Израђује и ставља ЦСС и ЈаваСцрипт за документе. Затим можете покренути документацију локално преко npm run docs-serve.

Покрените npm runда видите све нпм скрипте.

Аутопрефикер

Боотстрап користи Аутопрефикер (укључен у наш процес прављења) за аутоматско додавање префикса добављача неким ЦСС својствима у време израде. На тај начин штедимо време и код, омогућавајући нам да напишемо кључне делове нашег ЦСС-а у једном тренутку док елиминишемо потребу за миксинама добављача попут оних који се налазе у в3.

Ми одржавамо листу прегледача подржаних преко Аутопрефикер-а у посебној датотеци у нашем ГитХуб репозиторијуму. Погледајте .бровсерслистрц за детаље.

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

Локално покретање наше документације захтева употребу Јекилл-а, прилично флексибилног генератора статичких локација који нам пружа: основне ставке, датотеке засноване на Маркдовн-у, шаблоне и још много тога. Ево како да започнете:

  1. Прођите кроз горенаведена подешавања алата да бисте инсталирали Јекилл (градитељ сајтова) и друге Руби зависности са bundle install.
  2. Из основног /bootstrapдиректоријума покрените npm run docs-serveу командној линији.
  3. Отворите http://localhost:9001у свом претраживачу и воила.

Сазнајте више о коришћењу Јекилл-а читајући његову документацију .

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

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