Doprinesite

Pomozite u razvoju Bootstrapa s našim skriptama i testovima za izradu dokumentacije.

Na ovoj stranici

Postavljanje alata

Bootstrap koristi npm skripte za izradu dokumentacije i kompajliranje izvornih datoteka. Naš package.json sadrži ove skripte za kompajliranje koda, pokretanje testova i još mnogo toga. Oni nisu namijenjeni za upotrebu izvan našeg spremišta i dokumentacije.

Da biste koristili naš sistem izgradnje i lokalno pokrenuli našu dokumentaciju, trebat će vam kopija izvornih datoteka Bootstrapa i Node. Slijedite ove korake i trebali biste biti spremni za rock:

Preuzmite i instalirajte Node.js , koji koristimo za upravljanje našim ovisnostima.
Ili preuzmite Bootstrapove izvore ili fork Bootstrapovo spremište .
Idite do korijenskog /bootstrapdirektorija i pokrenite npm installda instalirate naše lokalne ovisnosti navedene u package.json .

Kada završite, moći ćete da pokrenete različite komande koje ste dobili iz komandne linije.

Korištenje npm skripti

Naš package.json uključuje brojne zadatke za razvoj projekta. Pokrenite npm runda vidite sve npm skripte u vašem terminalu. Primarni zadaci uključuju:

Zadatak	Opis
`npm start`	Kompajlira CSS i JavaScript, pravi dokumentaciju i pokreće lokalni server.
`npm run dist`	Kreira `dist/`direktorij s kompajliranim datotekama. Zahtijeva Sass , Autoprefixer i terser .
`npm test`	Pokreće testove lokalno nakon pokretanja`npm run dist`
`npm run docs-serve`	Gradi i pokreće dokumentaciju lokalno.

Započnite s Bootstrapom putem npm-a s našim početnim projektom! Idite na twbs/bootstrap-npm-starter spremište šablona da vidite kako izgraditi i prilagoditi Bootstrap u svom vlastitom npm projektu. Uključuje Sass kompajler, Autoprefixer, Stylelint, PurgeCSS i Bootstrap ikone.

Sass

Bootstrap koristi Dart Sass za kompajliranje naših Sass izvornih datoteka u CSS datoteke (uključene u naš proces izgradnje), i preporučujemo da učinite isto ako kompajlirate Sass koristeći svoj vlastiti cjevovod sredstava. Ranije smo koristili Node Sass za Bootstrap v4, ali LibSass i paketi izgrađeni na njemu, uključujući Node Sass, sada su zastarjeli .

Dart Sass koristi preciznost zaokruživanja od 10 i iz razloga efikasnosti ne dozvoljava podešavanje ove vrijednosti. Ne smanjujemo ovu preciznost tokom dalje obrade našeg generisanog CSS-a, kao što je tokom minifikacije, ali ako to odaberete, preporučujemo da zadržite preciznost od najmanje 6 kako biste sprečili probleme sa zaokruživanjem pretraživača.

Autoprefixer

Bootstrap koristi Autoprefixer (uključen u naš proces izgradnje) za automatsko dodavanje prefiksa dobavljača nekim CSS svojstvima u vrijeme izrade. Na taj način ��tedimo vrijeme i kod, omogućavajući nam da napišemo ključne dijelove našeg CSS-a samo jednom, dok eliminiramo potrebu za miksinama dobavljača poput onih u v3.

Mi održavamo listu pretraživača podržanih kroz Autoprefixer u zasebnoj datoteci unutar našeg GitHub repozitorija. Pogledajte .browserslistrc za detalje.

RTLCSS

Bootstrap koristi RTLCSS za obradu kompajliranih CSS-a i pretvaranje ih u RTL – u osnovi zamjenjujući svojstva svjesne horizontalnog smjera (npr. padding-left) njihovim suprotnim. Omogućava nam da napišemo naš CSS samo jedanput i napravimo manja podešavanja koristeći RTLCSS kontrolne i vrijednosne direktive.

Lokalna dokumentacija

Lokalno pokretanje naše dokumentacije zahtijeva korištenje Hugoa, koji se instalira preko paketa hugo-bin npm. Hugo je nevjerovatno brz i prilično proširiv generator statičkih stranica koji nam pruža: osnovne uključene, datoteke zasnovane na Markdownu, šablone i još mnogo toga. Evo kako započeti:

Prođite kroz postavke alata iznad da biste instalirali sve ovisnosti.
Iz korijenskog /bootstrapdirektorija pokrenite npm run docs-serveu komandnoj liniji.
Otvorite http://localhost:9001/u svom pretraživaču i voilà.

Saznajte više o korištenju Huga čitajući njegovu dokumentaciju .

Rješavanje problema

Ako naiđete na probleme s instaliranjem ovisnosti, deinstalirajte sve prethodne verzije ovisnosti (globalne i lokalne). Zatim, ponovite npm install.