Laktawan sa panguna nga sulud Laktaw sa docs navigation
in English

Paghimo og mga himan

Hibal-i kung giunsa paggamit ang gilakip nga mga script sa npm sa Bootstrap aron matukod ang among dokumentasyon, pag-compile sa source code, pagpadagan sa mga pagsulay, ug uban pa.

Pag-setup sa gamit

Ang Bootstrap naggamit sa npm script para sa sistema sa pagtukod niini. Ang among package.json naglakip sa kombenyente nga mga pamaagi sa pagtrabaho kauban ang framework, lakip ang pag-compile sa code, pagpadagan sa mga pagsulay, ug uban pa.

Aron magamit ang among sistema sa pagtukod ug ipadagan ang among dokumentasyon sa lokal, kinahanglan nimo ang usa ka kopya sa mga gigikanan nga file sa Bootstrap ug Node. Sunda kini nga mga lakang ug kinahanglan nga andam ka sa pag-rock:

  1. I-download ug i-install ang Node.js , nga among gigamit sa pagdumala sa among mga dependency.
  2. Mahimong i-download ang mga gigikanan sa Bootstrap o ang tinidor nga tipiganan sa Bootstrap .
  3. Pagdala ngadto sa root /bootstrapdirectory ug pagdagan npm installaron i-install ang among mga lokal nga dependency nga gilista sa package.json .

Kung nahuman na, mahimo nimong ipadagan ang lainlaing mga mando nga gihatag gikan sa linya sa mando.

Paggamit sa npm script

Ang among package.json naglakip sa daghang mga buluhaton alang sa pagpalambo sa proyekto. Pagdagan npm runaron makita ang tanan nga npm script sa imong terminal. Ang mga nag-unang buluhaton naglakip sa:

Buluhaton Deskripsyon
npm start Nag-compile sa CSS ug JavaScript, nagtukod sa dokumentasyon, ug nagsugod sa usa ka lokal nga server.
npm run dist Naghimo sa dist/direktoryo nga adunay mga gihugpong nga mga file. Nagkinahanglan og Sass , Autoprefixer , ug terser .
npm test Gipadagan ang mga pagsulay sa lokal pagkahuman sa pagdagannpm run dist
npm run docs-serve Nagtukod ug nagpadagan sa dokumentasyon sa lokal.
Pagsugod sa Bootstrap pinaagi sa npm sa among starter nga proyekto! Pangadto sa twbs/bootstrap-npm-starter template repository aron makita kung unsaon paghimo ug pag-customize sa Bootstrap sa imong kaugalingong npm project. Naglakip sa Sass compiler, Autoprefixer, Stylelint, PurgeCSS, ug Bootstrap Icons.

Sass

Gigamit sa Bootstrap ang Dart Sass para sa pag-compile sa among Sass source files ngadto sa CSS files (apil sa among proseso sa pagtukod), ug among girekomendar nga buhaton nimo ang parehas kung imong gi-compile ang Sass gamit ang imong kaugalingong asset pipeline. Gigamit namon kaniadto ang Node Sass para sa Bootstrap v4, apan ang LibSass ug mga pakete nga gitukod sa ibabaw niini, lakip ang Node Sass, wala na magamit .

Ang Dart Sass naggamit sa usa ka rounding precision sa 10 ug alang sa efficiency nga mga rason wala magtugot sa pag-adjust niini nga bili. Dili namo ipaubos kini nga katukma sa panahon sa dugang nga pagproseso sa among namugna nga CSS, sama sa panahon sa pagminus, apan kung gipili nimo nga buhaton kini among girekomenda nga magmentinar sa katukma nga labing menos 6 aron malikayan ang mga isyu sa paglibot sa browser.

Autoprefixer

Gigamit sa Bootstrap ang Autoprefixer (apil sa among proseso sa pagtukod) aron awtomatikong idugang ang mga prefix sa vendor sa pipila ka mga kabtangan sa CSS sa oras sa pagtukod. Ang pagbuhat sa ingon makadaginot kanamo sa oras ug code pinaagi sa pagtugot kanamo sa pagsulat sa hinungdanon nga mga bahin sa among CSS sa usa ka higayon samtang giwagtang ang panginahanglan alang sa mga mixin sa vendor sama sa nakit-an sa v3.

Gipadayon namo ang listahan sa mga browser nga gisuportahan pinaagi sa Autoprefixer sa usa ka bulag nga file sulod sa among GitHub repository. Tan-awa ang .browserslistrc para sa mga detalye.

RTLCSS

Gigamit sa Bootstrap ang RTLCSS aron maproseso ang giipon nga CSS ug i-convert kini sa RTL - sa panguna gipulihan ang pinahigda nga direksyon nga nahibal-an ang mga kabtangan (pananglitan. padding-left) sa kaatbang niini. Gitugotan kami nga isulat lamang ang among CSS sa usa ka higayon ug maghimo gamay nga pag-tweak gamit ang kontrol sa RTLCSS ug mga direktiba sa kantidad .

Lokal nga dokumentasyon

Ang pagpadagan sa among lokal nga dokumentasyon nanginahanglan sa paggamit sa Hugo, nga ma-install pinaagi sa hugo-bin npm package. Ang Hugo usa ka kusog kaayo ug labi ka daghan nga static nga generator sa site nga naghatag kanamo: sukaranan nga naglakip, mga file nga nakabase sa Markdown, template, ug uban pa. Ania kung giunsa kini pagsugod:

  1. Pagdalagan pinaagi sa pag-setup sa tooling sa ibabaw aron ma-install ang tanan nga mga dependency.
  2. Gikan sa root /bootstrapdirectory, pagdagan npm run docs-servesa command line.
  3. Ablihi http://localhost:9001/sa imong browser, ug voilà.

Pagkat-on og dugang mahitungod sa paggamit sa Hugo pinaagi sa pagbasa sa dokumentasyon niini .

Pag-troubleshoot

Kung makasugat ka ug mga problema sa pag-install sa mga dependency, i-uninstall ang tanan nga mga naunang bersyon sa dependency (global ug lokal). Unya, ipadayon pag-usab npm install.