Source

Bygg verktøy

Lær hvordan du bruker Bootstraps inkluderte npm-skript for å bygge vår dokumentasjon, kompilere kildekode, kjøre tester og mer.

Verktøyoppsett

Bootstrap bruker NPM-skript for byggesystemet sitt. Vår package.json inkluderer praktiske metoder for å jobbe med rammeverket, inkludert kompilering av kode, kjøring av tester og mer.

For å bruke byggesystemet vårt og kjøre dokumentasjonen lokalt, trenger du en kopi av Bootstraps kildefiler og Node. Følg disse trinnene og du bør være klar til å rocke:

  1. Last ned og installer Node.js , som vi bruker til å administrere avhengighetene våre.
  2. Naviger til rotkatalogen /bootstrapog kjør npm installfor å installere våre lokale avhengigheter oppført i package.json .
  3. Installer Ruby , installer Bundler med gem install bundler, og kjør til slutt bundle install. Dette vil installere alle Ruby-avhengigheter, som Jekyll og plugins.

Når du er ferdig, vil du kunne kjøre de forskjellige kommandoene fra kommandolinjen.

Bruker NPM-skript

Vår package.json inneholder følgende kommandoer og oppgaver:

Oppgave Beskrivelse
npm run dist npm run distoppretter /distkatalogen med kompilerte filer. Bruker Sass , Autoprefixer og UglifyJS .
npm test Samme som npm run distpluss at den kjører tester lokalt
npm run docs Bygger og fletter CSS og JavaScript for dokumenter. Du kan da kjøre dokumentasjonen lokalt via npm run docs-serve.

Kjør npm runfor å se alle npm-skriptene.

Autoprefikser

Bootstrap bruker Autoprefixer (inkludert i byggeprosessen vår) for automatisk å legge til leverandørprefikser til enkelte CSS-egenskaper ved byggetidspunkt. Å gjøre det sparer oss for tid og kode ved å la oss skrive viktige deler av CSS-en vår én gang, samtidig som vi eliminerer behovet for leverandørmikser som de som finnes i v3.

Vi opprettholder listen over nettlesere som støttes gjennom Autoprefixer i en egen fil i vårt GitHub-lager. Se /package.json for detaljer.

Lokal dokumentasjon

Å kjøre dokumentasjonen vår lokalt krever bruk av Jekyll, en anstendig fleksibel statisk nettstedsgenerator som gir oss: grunnleggende inkluderer, Markdown-baserte filer, maler og mer. Slik kommer du i gang:

  1. Kjør gjennom verktøyoppsettet ovenfor for å installere Jekyll (nettstedbyggeren) og andre Ruby-avhengigheter med bundle install.
  2. Fra rotkatalogen /bootstrap, kjør npm run docs-servepå kommandolinjen.
  3. Åpne http://localhost:9001i nettleseren din, og voilà.

Lær mer om bruk av Jekyll ved å lese dokumentasjonen .

Feilsøking

Skulle du støte på problemer med å installere avhengigheter, avinstaller alle tidligere avhengighetsversjoner (globale og lokale). Kjør deretter på nytt npm install.