Допринесите

Помозите у развоју Боотстрап-а помоћу наших скрипти и тестова за прављење документације.

На овој страници

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

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

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

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

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

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

Наш пацкаге.јсон укључује бројне задатке за развој пројекта. Покрените npm runда видите све нпм скрипте у вашем терминалу. Примарни задаци укључују:

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

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

Сасс

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

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

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

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

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

РТЛЦСС

Боотстрап користи РТЛЦСС да обради компајлирани ЦСС и конвертује их у РТЛ – у основи замењујући својства свесне хоризонталног правца (нпр. padding-left) њиховим супротним. Омогућава нам да напишемо наш ЦСС само једанпут и да направимо мања подешавања користећи РТЛЦСС контроле и директиве вредности .

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

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

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

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

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

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