Source

Bou gereedskap

Leer hoe om Bootstrap se ingeslote npm-skrifte te gebruik om ons dokumentasie te bou, bronkode saam te stel, toetse uit te voer, en meer.

Gereedskap opstelling

Bootstrap gebruik npm-skrifte vir sy boustelsel. Ons package.json bevat gerieflike metodes om met die raamwerk te werk, insluitend die samestelling van kode, die uitvoer van toetse, en meer.

Om ons boustelsel te gebruik en ons dokumentasie plaaslik te laat loop, het jy 'n kopie van Bootstrap se bronlêers en Node nodig. Volg hierdie stappe en jy moet gereed wees om te rock:

  1. Laai af en installeer Node.js , wat ons gebruik om ons afhanklikhede te bestuur.
  2. Navigeer na die wortelgids /bootstrapen hardloop npm installom ons plaaslike afhanklikhede wat in package.json gelys is, te installeer .
  3. Installeer Ruby , installeer Bundler met gem install bundler, en hardloop uiteindelik bundle install. Dit sal alle Ruby-afhanklikhede, soos Jekyll en plugins, installeer.
    • Windows-gebruikers: Lees hierdie gids om Jekyll sonder probleme aan die gang te kry.

Wanneer dit voltooi is, sal jy die verskillende opdragte wat vanaf die opdragreël verskaf word, kan uitvoer.

Gebruik npm skrifte

Ons package.json bevat die volgende opdragte en take:

Taak Beskrywing
npm run dist npm run distskep die /dist/gids met saamgestelde lêers. Gebruik Sass , Autoprefixer en UglifyJS .
npm test Dieselfde as npm run distplus dit voer toetse plaaslik uit
npm run docs Bou en pluis CSS en JavaScript vir dokumente. U kan dan die dokumentasie plaaslik uitvoer via npm run docs-serve.

Hardloop npm runom al die npm-skrifte te sien.

Autoprefixer

Bootstrap gebruik Autoprefixer (ingesluit by ons bouproses) om verskaffervoorvoegsels outomaties by sommige CSS-eienskappe by te voeg tydens boutyd. Deur dit te doen, bespaar ons tyd en kode deur ons in staat te stel om sleuteldele van ons CSS 'n enkele keer te skryf, terwyl die behoefte aan verskaffermengsels soos dié wat in v3 gevind word, uitskakel.

Ons hou die lys blaaiers wat deur Autoprefixer ondersteun word in 'n aparte lêer binne ons GitHub-bewaarplek. Sien .browserslistrc vir besonderhede.

Plaaslike dokumentasie

Om ons dokumentasie plaaslik te laat loop, vereis die gebruik van Jekyll, 'n ordentlike buigsame statiese werfgenerator wat ons voorsien: basiese insluit, Markdown-gebaseerde lêers, sjablone en meer. Hier is hoe om dit aan die gang te kry:

  1. Gaan deur die gereedskapopstelling hierbo om Jekyll (die werfbouer) en ander Ruby-afhanklikhede met bundle install.
  2. Uit die wortelgids /bootstrap, hardloop npm run docs-servein die opdragreël.
  3. Maak oop http://localhost:9001in jou blaaier, en voilà.

Kom meer te wete oor die gebruik van Jekyll deur die dokumentasie daarvan te lees .

Probleemoplossing

As jy probleme ondervind met die installering van afhanklikhede, verwyder alle vorige afhanklikheidsweergawes (wêreldwyd en plaaslik). Dan, herlaai npm install.