Source

Hulpmiddelen bouwen

Leer hoe u de meegeleverde npm-scripts van Bootstrap kunt gebruiken om onze documentatie te bouwen, de broncode te compileren, tests uit te voeren en meer.

Gereedschapsconfiguratie

Bootstrap gebruikt NPM-scripts voor het buildsysteem. Onze package.json bevat handige methoden om met het framework te werken, waaronder het compileren van code, het uitvoeren van tests en meer.

Om ons buildsysteem te gebruiken en onze documentatie lokaal uit te voeren, heb je een kopie van Bootstrap's bronbestanden en Node nodig. Volg deze stappen en je zou klaar moeten zijn om te rocken:

  1. Download en installeer Node.js , die we gebruiken om onze afhankelijkheden te beheren.
  2. Navigeer naar de hoofdmap /bootstrapen voer npm installdeze uit om onze lokale afhankelijkheden te installeren die worden vermeld in package.json .
  3. Installeer Ruby , installeer Bundler met gem install bundleren voer ten slotte uit bundle install. Hiermee worden alle Ruby-afhankelijkheden geïnstalleerd, zoals Jekyll en plug-ins.
    • Windows-gebruikers: Lees deze handleiding om Jekyll probleemloos aan de slag te krijgen.

Als u klaar bent, kunt u de verschillende opdrachten uitvoeren vanaf de opdrachtregel.

NPM-scripts gebruiken

Onze package.json bevat de volgende opdrachten en taken:

Taak Beschrijving
npm run dist npm run distmaakt de /distmap met gecompileerde bestanden. Gebruikt Sass , Autoprefixer en UglifyJS .
npm test Hetzelfde als npm run distplus het voert lokaal tests uit
npm run docs Bouwt en pluist CSS en JavaScript voor documenten. U kunt de documentatie vervolgens lokaal uitvoeren via npm run docs-serve.

Uitvoeren npm runom alle npm-scripts te zien.

Autoprefixer

Bootstrap gebruikt Autoprefixer (inbegrepen in ons bouwproces) om tijdens het bouwen automatisch leveranciersvoorvoegsels toe te voegen aan sommige CSS-eigenschappen. Door dit te doen, besparen we tijd en code doordat we de belangrijkste delen van onze CSS in één keer kunnen schrijven, terwijl we de noodzaak voor leveranciersmixins zoals die in v3.

We houden de lijst met browsers die worden ondersteund door Autoprefixer bij in een apart bestand in onze GitHub-repository. Zie /package.json voor details.

Lokale documentatie

Om onze documentatie lokaal uit te voeren, is het gebruik van Jekyll vereist, een behoorlijk flexibele generator voor statische sites die ons voorziet van: basisinhoud, op Markdown gebaseerde bestanden, sjablonen en meer. Hier leest u hoe u eraan begint:

  1. Doorloop de tooling-instellingen hierboven om Jekyll (de sitebuilder) en andere Ruby-afhankelijkheden te installeren met bundle install.
  2. /bootstrapVoer vanuit de hoofdmap uit npm run docs-servein de opdrachtregel.
  3. Open http://localhost:9001in uw browser en voilà.

Lees meer over het gebruik van Jekyll door de documentatie te lezen .

Probleemoplossen

Als u problemen ondervindt met het installeren van afhankelijkheden, verwijder dan alle eerdere versies van afhankelijkheid (algemeen en lokaal). Daarna opnieuw uitvoeren npm install.