Source

Bouwe ark

Learje hoe't jo de ynbegrepen npm-skripts fan Bootstrap brûke om ús dokumintaasje te bouwen, boarnekoade te kompilearjen, tests út te fieren, en mear.

Tooling opset

Bootstrap brûkt npm-skripts foar har buildsysteem. Us package.json omfettet handige metoaden foar it wurkjen mei it ramt, ynklusyf it kompilearjen fan koade, it útfieren fan tests, en mear.

Om ús buildsysteem te brûken en ús dokumintaasje lokaal út te fieren, hawwe jo in kopy fan Bootstrap's boarnebestannen en Node nedich. Folgje dizze stappen en jo moatte ree wêze om te rocken:

  1. Download en ynstallearje Node.js , dy't wy brûke om ús ôfhinklikens te behearjen.
  2. Navigearje nei de root- /bootstrapmap en rinne npm installom ús lokale ôfhinklikens te ynstallearjen neamd yn package.json .
  3. Ynstallearje Ruby , ynstallearje Bundler mei gem install bundler, en einlings útfiere bundle install. Dit sil alle Ruby-ôfhinklikens ynstalleare, lykas Jekyll en plugins.
    • Windows-brûkers: Lês dizze hantlieding om Jekyll sûnder problemen op en te rinnen.

As jo ​​​​foltôge binne, kinne jo de ferskate kommando's útfiere fan 'e kommandorigel.

It brûken fan npm-skripts

Us package.json omfettet de folgjende kommando's en taken:

Taak Beskriuwing
npm run dist npm run distmakket de /dist/map mei kompilearre bestannen. Brûkt Sass , Autoprefixer , en UglifyJS .
npm test Itselde as npm run distplus it rint tests lokaal
npm run docs Bout en lint CSS en JavaScript foar dokuminten. Jo kinne dan de dokumintaasje lokaal útfiere fia npm run docs-serve.

Rinne npm runom alle npm-skripts te sjen.

Autoprefixer

Bootstrap brûkt Autoprefixer (ynklusyf yn ús bouproses) om ferkeaperfoarheaksels automatysk ta te foegjen oan guon CSS-eigenskippen yn 'e boutiid. Troch dit te dwaan besparret ús tiid en koade troch ús te tastean wichtige dielen fan ús CSS ien kear te skriuwen, wylst de needsaak foar ferkeapermixins lykas dy fûn yn v3 elimineare.

Wy ûnderhâlde de list mei browsers dy't wurde stipe troch Autoprefixer yn in apart bestân binnen ús GitHub-repository. Sjoch .browserslistrc foar details.

Lokale dokumintaasje

It útfieren fan ús dokumintaasje lokaal fereasket it gebrûk fan Jekyll, in fatsoenlik fleksibele statyske sidegenerator dy't ús leveret: basis omfettet, Markdown-basearre bestannen, sjabloanen, en mear. Hjir is hoe't jo it begjinne kinne:

  1. Rinne troch de tooling-opset hjirboppe om Jekyll (de sidebouwer) en oare Ruby-ôfhinklikens te ynstallearjen mei bundle install.
  2. Fanút de root- /bootstrapmap, rinne npm run docs-serveyn 'e kommandorigel.
  3. Iepenje http://localhost:9001yn jo blêder, en voilà.

Learje mear oer it brûken fan Jekyll troch de dokumintaasje te lêzen .

Problemen oplosse

Mochten jo problemen tsjinkomme mei it ynstallearjen fan ôfhinklikens, ferwiderje dan alle eardere ôfhinklikensferzjes (globaal en lokaal). Dan, werhelje npm install.