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:

Last ned og installer Node.js , som vi bruker til å administrere avhengighetene våre.
Naviger til rotkatalogen /bootstrapog kjør npm installfor å installere våre lokale avhengigheter oppført i package.json .
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.
- Windows-brukere: Les denne veiledningen for å få Jekyll i gang uten problemer.

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

Bruker NPM-skript

Our package.json includes the following commands and tasks:

Task	Description
`npm run dist`	`npm run dist` creates the `/dist` directory with compiled files. Uses Sass, Autoprefixer, and UglifyJS.
`npm test`	Same as `npm run dist` plus it runs tests locally
`npm run docs`	Builds and lints CSS and JavaScript for docs. You can then run the documentation locally via `npm run docs-serve`.

Run npm run to see all the npm scripts.

Autoprefixer

Bootstrap uses Autoprefixer (included in our build process) to automatically add vendor prefixes to some CSS properties at build time. Doing so saves us time and code by allowing us to write key parts of our CSS a single time while eliminating the need for vendor mixins like those found in v3.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /.browserslistrc 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:

Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
From the root /bootstrap directory, run npm run docs-serve in the command line.
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.