in English

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

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

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

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

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

  1. Преузмите и инсталирајте Ноде.јс , који користимо за управљање нашим зависностима.
  2. Или преузмите Боотстрап-ове изворе или раздвојите Боотстрап-ово спремиште .
  3. Идите до основног /bootstrapдиректоријума и покрените npm installда инсталирате наше локалне зависности наведене у пацкаге.јсон .

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

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

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

Задатак Опис
npm run dist npm run distкреира /dist/директоријум са компајлираним датотекама. Користи Сасс , Аутопрефикер и терсер .
npm test Покреће тестове локално након покретањаnpm run dist
npm run docs-serve Гради и покреће документацију локално.

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

Започните са Боотстрапом преко нпм-а са нашим почетним пројектом! Идите на твбс/боотстрап-нпм-стартер спремиште шаблона да видите како да направите и прилагодите Боотстрап у свом сопственом нпм пројекту. Укључује Сасс компајлер, Аутопрефикер, Стилелинт, ПургеЦСС и Боотстрап иконе.

Сасс

Боотстрап в4 користи Ноде Сасс за компајлирање наших Сасс изворних датотека у ЦСС датотеке (укључене у наш процес изградње). Да бисте завршили са истим генерисаним ЦСС-ом приликом компајлирања Сасс-а користећи сопствени цевовод средстава, мораћете да користите Сасс компајлер који подржава барем функције које Ноде Сасс ради. Ово је важно напоменути јер су од 26. октобра 2020. ЛибСасс и пакети изграђени на њему—укључујући Ноде Сасс— застарели .

Ако су вам потребне новије Сасс функције или компатибилност са новијим ЦСС стандардима, Дарт Сасс је сада примарна имплементација Сасс-а и подржава ЈаваСцрипт АПИ који је потпуно компатибилан са Ноде Сасс-ом (са неколико изузетака наведених на ГитХуб страници Дарт Сасс-а ).

Повећавамо прецизност заокруживања Сасс-а на 6 (подразумевано је 5 у Ноде Сасс-у) да бисмо спречили проблеме са заокруживањем претраживача. Ако користите Дарт Сасс, ово неће бити нешто што треба да прилагодите, јер тај компајлер користи прецизност заокруживања од 10 и из разлога ефикасности не дозвољава да се то прилагоди.

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

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

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

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

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

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

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

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

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