Source

Alati za gradnju

Naučite kako koristiti uključene Bootstrapove npm skripte za izradu naše dokumentacije, kompajliranje izvornog koda, izvođenje testova i više.

Postavljanje alata

Bootstrap koristi NPM skripte za svoj sustav izgradnje. Naš package.json uključuje prikladne metode za rad s okvirom, uključujući kompajliranje koda, izvođenje testova i više.

Da biste koristili naš sustav izrade i lokalno pokrenuli našu dokumentaciju, trebat će vam kopija Bootstrapovih izvornih datoteka i čvora. Slijedite ove korake i trebali biste biti spremni za rock:

  1. Preuzmite i instalirajte Node.js , koji koristimo za upravljanje našim ovisnostima.
  2. Dođite do korijenskog /bootstrapdirektorija i pokrenite npm installda biste instalirali naše lokalne ovisnosti navedene u package.json .
  3. Instalirajte Ruby , instalirajte Bundler s gem install bundleri na kraju pokrenite bundle install. Ovo će instalirati sve Ruby ovisnosti, kao što su Jekyll i dodaci.
    • Korisnici Windowsa: Pročitajte ovaj vodič kako biste pokrenuli Jekyll bez problema.

Kada završite, moći ćete pokrenuti različite naredbe iz naredbenog retka.

Korištenje NPM skripti

Naš package.json uključuje sljedeće naredbe i zadatke:

Zadatak Opis
npm run dist npm run diststvara /distdirektorij s kompiliranim datotekama. Koristi Sass , Autoprefixer i UglifyJS .
npm test Isto kao npm run distplus, izvodi testove lokalno
npm run docs Gradi i crta CSS i JavaScript za dokumente. Zatim možete pokrenuti dokumentaciju lokalno putem npm run docs-serve.

Pokrenite npm runda biste vidjeli sve npm skripte.

Automatski prefiks

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

Održavamo popis preglednika podržanih kroz Autoprefixer u zasebnoj datoteci unutar našeg GitHub repozitorija. Pogledajte /package.json za detalje.

Lokalna dokumentacija

Lokalno pokretanje naše dokumentacije zahtijeva upotrebu Jekylla, pristojno fleksibilnog generatora statičnih web stranica koji nam pruža: osnovna uključuje, datoteke temeljene na Markdownu, predloške i još mnogo toga. Evo kako to započeti:

  1. Prođite kroz gornju postavku alata da biste instalirali Jekyll (sastavljač web stranica) i druge Ruby ovisnosti s bundle install.
  2. Iz korijenskog /bootstrapdirektorija pokrenite npm run docs-servenaredbeni redak.
  3. Otvorite http://localhost:9001u pregledniku i evo.

Saznajte više o korištenju Jekylla č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.