Pagtampo

Pag-setup sa gamit

Ang Bootstrap naggamit sa npm script aron matukod ang dokumentasyon ug mag-compile sa mga source file. Ang among package.json nagbutang niini nga mga script alang sa pag-compile sa code, pagpadagan sa mga pagsulay, ug uban pa. Wala kini gituyo nga gamiton sa gawas sa among repository ug dokumentasyon.

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:

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 lang ang among CSS sa usa ka higayon ug maghimo mga menor de edad nga pag-tweak gamit ang kontrol sa RTLCSS ug mga direktiba sa kantidad .

Lokal nga dokumentasyon

Ang pagpadagan sa among dokumentasyon sa lokal nagkinahanglan 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, ibalik npm install.