Source

Bygg verktyg

Lär dig hur du använder Bootstraps medföljande npm-skript för att bygga vår dokumentation, kompilera källkod, köra tester och mer.

Verktygsinställning

Bootstrap använder NPM-skript för sitt byggsystem. Vår package.json innehåller praktiska metoder för att arbeta med ramverket, inklusive kompilering av kod, körning av tester och mer.

För att använda vårt byggsystem och köra vår dokumentation lokalt behöver du en kopia av Bootstraps källfiler och Node. Följ dessa steg och du bör vara redo att rocka:

  1. Ladda ner och installera Node.js , som vi använder för att hantera våra beroenden.
  2. Navigera till rotkatalogen /bootstrapoch kör npm installför att installera våra lokala beroenden som anges i package.json .
  3. Installera Ruby , installera Bundler med gem install bundleroch kör slutligen bundle install. Detta kommer att installera alla Ruby-beroenden, såsom Jekyll och plugins.
    • Windows-användare: Läs den här guiden för att få Jekyll igång utan problem.

När du är klar kommer du att kunna köra de olika kommandona från kommandoraden.

Använder NPM-skript

Vår package.json innehåller följande kommandon och uppgifter:

Uppgift Beskrivning
npm run dist npm run distskapar /distkatalogen med kompilerade filer. Använder Sass , Autoprefixer och UglifyJS .
npm test Samma som npm run distplus att den kör tester lokalt
npm run docs Bygger och lintar CSS och JavaScript för dokument. Du kan sedan köra dokumentationen lokalt via npm run docs-serve.

Kör npm runför att se alla npm-skript.

Autoprefixer

Bootstrap använder Autoprefixer (ingår i vår byggprocess) för att automatiskt lägga till leverantörsprefix till vissa CSS-egenskaper vid byggtiden. Genom att göra det sparar vi tid och kod genom att tillåta oss att skriva viktiga delar av vår CSS en gång samtidigt som vi eliminerar behovet av leverantörsmixins som de som finns i v3.

Vi upprätthåller listan över webbläsare som stöds av Autoprefixer i en separat fil i vårt GitHub-förråd. Se /.browserslistrc för detaljer.

Lokal dokumentation

Att köra vår dokumentation lokalt kräver användning av Jekyll, en anständigt flexibel statisk webbplatsgenerator som ger oss: grundläggande inkluderar, Markdown-baserade filer, mallar och mer. Så här kommer du igång:

  1. Kör igenom verktygsinställningarna ovan för att installera Jekyll (webbplatsbyggaren) och andra Ruby-beroenden med bundle install.
  2. Kör på kommandoraden från /bootstraprotkatalogen .npm run docs-serve
  3. Öppna http://localhost:9001i din webbläsare och voilà.

Lär dig mer om att använda Jekyll genom att läsa dess dokumentation .

Felsökning

Om du skulle stöta på problem med att installera beroenden, avinstallera alla tidigare beroendeversioner (globala och lokala). Kör sedan igen npm install.