Алати за прављење
Научите како да користите укључене нпм скрипте Боотстрапа за прављење наше документације, компајлирање изворног кода, покретање тестова и још много тога.
Подешавање алата
Боотстрап користи НПМ скрипте за свој систем изградње. Наш пацкаге.јсон укључује згодне методе за рад са оквиром, укључујући компајлирање кода, покретање тестова и још много тога.
Да бисте користили наш систем изградње и локално покренули нашу документацију, требаће вам копија изворних датотека Боотстрапа и Ноде. Следите ове кораке и требало би да будете спремни за љуљање:
- Преузмите и инсталирајте Ноде.јс , који користимо за управљање нашим зависностима.
- Идите до основног
/bootstrap
директоријума и покренитеnpm install
да инсталирате наше локалне зависности наведене у пацкаге.јсон . - Инсталирајте Руби , инсталирајте Бундлер са
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.
Ми одржавамо листу прегледача подржаних преко Аутопрефикер-а у посебној датотеци у нашем ГитХуб репозиторијуму. Погледајте /.бровсерслистрц за детаље.
Локална документација
Локално покретање наше документације захтева употребу Јекилл-а, прилично флексибилног генератора статичких локација који нам пружа: основне ставке, датотеке засноване на Маркдовн-у, шаблоне и још много тога. Ево како да започнете:
- Прођите кроз горенаведена подешавања алата да бисте инсталирали Јекилл (градитељ сајтова) и друге Руби зависности са
bundle install
. - Из основног
/bootstrap
директоријума покренитеnpm run docs-serve
у командној линији. - Отворите
http://localhost:9001
у свом претраживачу и воила.
Сазнајте више о коришћењу Јекилл-а читајући његову документацију .
Решавање проблема
Ако наиђете на проблеме са инсталирањем зависности, деинсталирајте све претходне верзије зависности (глобалне и локалне). Затим, поновите npm install
.