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:
- I-download ug i-install ang Node.js , nga among gigamit sa pagdumala sa among mga dependency.
- Mahimong i-download ang mga gigikanan sa Bootstrap o ang tinidor nga tipiganan sa Bootstrap .
- Pagdala ngadto sa root
/bootstrap
directory ug pagdagannpm install
aron 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 run
aron 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. |
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:
- Pagdalagan pinaagi sa pag-setup sa tooling sa ibabaw aron ma-install ang tanan nga mga dependency.
- Gikan sa root
/bootstrap
directory, pagdagannpm run docs-serve
sa command line. - 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
.