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 noen CSS-egenskaper ved byggetidspunktet. Å 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.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /package.json for details.

Local documentation

Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  1. Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001 in your browser, and voilà.

Learn more about using Jekyll by reading its documentation.

Troubleshooting

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