Source

Alati za pravljenje

Naučite kako koristiti uključene npm skripte Bootstrapa za izradu naše dokumentacije, kompajliranje izvornog koda, pokretanje testova i još mnogo toga.

Postavljanje alata

Bootstrap koristi NPM skripte za svoj sistem izgradnje. Naš package.json uključuje zgodne metode za rad sa okvirom, uključujući kompajliranje koda, pokretanje testova i još mnogo toga.

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:

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

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 sljedeće naredbe i zadatke:

Zadatak Opis
npm run dist npm run distkreira /distdirektorij s kompajliranim datotekama. Koristi Sass , Autoprefixer i UglifyJS .
npm test Isto kao npm run distplus pokreće testove lokalno
npm run docs Izrađuje i stavlja CSS i JavaScript za dokumente. Zatim možete pokrenuti dokumentaciju lokalno putem npm run docs-serve.

Pokrenite npm runda vidite sve npm skripte.

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.

Lokalna dokumentacija

Lokalno pokretanje naše dokumentacije zahtijeva korištenje Jekyll-a, prilično fleksibilnog generatora statičkih stranica koji nam pruža: osnovne uključuje, datoteke zasnovane na Markdown-u, predloške i još mnogo toga. Evo kako započeti:

  1. Prođite kroz gornju postavku alata da biste instalirali Jekyll (graditelj stranice) i druge Ruby ovisnosti sa bundle install.
  2. Iz korijenskog /bootstrapdirektorija pokrenite npm run docs-serveu komandnoj liniji.
  3. Otvorite http://localhost:9001u svom pretraživaču i voilà.

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