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 mosunod nga mga sugo ug buluhaton:

Pagdagan npm runaron makita ang tanan nga mga script sa npm.

Sass

Ang Bootstrap v4 naggamit sa Node Sass para sa pag-compile sa among Sass source files ngadto sa CSS files (apil sa among build process). Aron mahuman ang parehas nga nahimo nga CSS sa pag-compile sa Sass gamit ang imong kaugalingon nga pipeline sa asset, kinahanglan nimo nga mogamit usa ka Sass compiler nga nagsuporta bisan sa mga bahin nga gihimo sa Node Sass. Mahinungdanon kini nga hinumdoman tungod kay kaniadtong Oktubre 26, 2020, ang LibSass ug mga pakete nga gitukod sa ibabaw niini-lakip ang Node Sass-wala na gigamit .

Kung kinahanglan nimo ang mas bag-ong mga bahin sa Sass o pagkaangay sa mas bag-ong mga sumbanan sa CSS, ang Dart Sass mao na ang panguna nga pagpatuman sa Sass ug nagsuporta sa usa ka JavaScript API nga hingpit nga nahiuyon sa Node Sass (uban ang pipila nga mga eksepsiyon nga gilista sa panid sa GitHub sa Dart Sass ).

Atong dugangan ang Sass rounding precision ngadto sa 6 (sa default, kini 5 sa Node Sass) aron malikayan ang mga isyu sa browser rounding. Kung mogamit ka sa Dart Sass dili kini usa ka butang nga kinahanglan nimo nga ayohon, tungod kay ang tig-compile naggamit sa usa ka rounding nga katukma sa 10 ug alang sa mga hinungdan sa kahusayan dili kini tugutan nga mabag-o.

Autoprefixer

Gigamit sa Bootstrap ang Autoprefixer (apil sa among proseso sa pagtukod) aron awtomatikong idugang ang mga prefix sa vendor sa pipila nga 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.

Among gipadayon 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.

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, ipadayon pag-usab npm install.