Source

Byg værktøjer

Lær, hvordan du bruger Bootstraps inkluderede npm-scripts til at bygge vores dokumentation, kompilere kildekode, køre tests og mere.

Værktøjsopsætning

Bootstrap bruger NPM-scripts til sit byggesystem. Vores package.json inkluderer praktiske metoder til at arbejde med rammeværket, herunder kompilering af kode, kørsel af tests og mere.

For at bruge vores byggesystem og køre vores dokumentation lokalt, skal du bruge en kopi af Bootstraps kildefiler og Node. Følg disse trin, og du bør være klar til at rocke:

  1. Download og installer Node.js , som vi bruger til at administrere vores afhængigheder.
  2. Naviger til rodmappen /bootstrapog kør npm installfor at installere vores lokale afhængigheder, der er angivet i package.json .
  3. Installer Ruby , installer Bundler med gem install bundler, og kør til sidst bundle install. Dette vil installere alle Ruby-afhængigheder, såsom Jekyll og plugins.
    • Windows-brugere: Læs denne guide for at få Jekyll op at køre uden problemer.

Når du er færdig, vil du være i stand til at køre de forskellige kommandoer fra kommandolinjen.

Brug af NPM-scripts

Vores package.json indeholder følgende kommandoer og opgaver:

Opgave Beskrivelse
npm run dist npm run distopretter /distmappen med kompilerede filer. Bruger Sass , Autoprefixer og UglifyJS .
npm test Samme som npm run distplus at den kører test lokalt
npm run docs Opbygger og fnugrer CSS og JavaScript til dokumenter. Du kan derefter køre dokumentationen lokalt via npm run docs-serve.

Kør npm runfor at se alle npm-scripts.

Autopræfikser

Bootstrap bruger Autoprefixer (inkluderet i vores byggeproces) til automatisk at tilføje leverandørpræfikser til nogle CSS-egenskaber på byggetidspunktet. Det sparer os tid og kode ved at give os mulighed for at skrive vigtige dele af vores CSS en enkelt gang, mens vi eliminerer behovet for leverandørmixins som dem, der findes i v3.

Vi vedligeholder listen over browsere, der understøttes af Autoprefixer, i en separat fil i vores GitHub-lager. Se /package.json for detaljer.

Lokal dokumentation

At køre vores dokumentation lokalt kræver brug af Jekyll, en anstændigt fleksibel statisk webstedsgenerator, der giver os: grundlæggende inkluderer, Markdown-baserede filer, skabeloner og mere. Sådan kommer du i gang:

  1. Kør gennem værktøjsopsætningen ovenfor for at installere Jekyll (webstedsbyggeren) og andre Ruby-afhængigheder med bundle install.
  2. /bootstrapKør npm run docs-servepå kommandolinjen fra rodmappen .
  3. Åbn http://localhost:9001i din browser, og voilà.

Lær mere om at bruge Jekyll ved at læse dens dokumentation .

Fejlfinding

Skulle du støde på problemer med at installere afhængigheder, skal du afinstallere alle tidligere afhængighedsversioner (globale og lokale). Kør derefter igen npm install.