in English

Qalab dhis

Baro sida loo isticmaalo Bootstrap's npm oo ay ku jiraan qoraallada si loo dhiso dukumeentigeena, u ururinno koodka isha, imtixaannada la wado, iyo in ka badan.

Habaynta qalabka

Bootstrap waxay u isticmaashaa npm scripts nidaamka dhismaheeda. Xidhmadayada.json waxa ku jira habab ku haboon oo loogu shaqaynayo qaabka, oo ay ku jiraan ururinta koodka, imtixaanada socodsiinta, iyo in ka badan.

Si aad u isticmaasho nidaamkayaga dhismaha oo aad u socodsiiso dukumeentiyadayada gudaha, waxaad u baahan doontaa nuqul ka mid ah faylasha isha Bootstrap iyo Node. Raac tillaabooyinkan oo waa inaad diyaar u ahaataa inaad ruxdo:

  1. Soo deji oo rakib Node.js , kaas oo aan isticmaalno si aan u maareyno ku tiirsanaantayada.
  2. Ama soo deji ilaha Bootstrap ama fargeetada Bootstrap's kaydka .
  3. U gudub tusaha xididka /bootstrapoo orod npm installsi aad u rakibto ku-tiirsanaanta deegaanka ee ku taxan xirmada.json .

Marka la dhammeeyo, waxaad awoodi doontaa inaad socodsiiso amarada kala duwan ee lagu bixiyo khadka taliska.

Isticmaalka qoraallada npm

Our pack.json waxa ku jira amarada iyo hawlaha soo socda:

Hawl Sharaxaada
npm run dist npm run distwuxuu abuuraa /dist/tusaha oo wata faylal la ururiyey. Wuxuu adeegsadaa Sass , Autoprefixer , iyo terser .
npm test Wuxuu sameeyaa imtixaanada gudaha ka dib marka uu ordonpm run dist
npm run docs-serve Wuxuu dhisaa oo maamulaa dukumentiyada gudaha.

Orod npm runsi aad u aragto dhammaan qoraallada npm

Ku bilow Bootstrap adigoo isticmaalaya npm mashruuceena bilawga ah! Madaxa twbs/bootstrap-npm-starter template repository si aad u aragto sida loo dhiso oo loo habeeyo Bootstrap mashruucaaga npm. Waxaa ku jira isku-duwaha Sass, Autoprefixer, Stylelint, PurgeCSS, iyo Astaamaha Bootstrap.

Sass

Bootstrap v4 waxay isticmaashaa Node Sass si ay u ururiso faylalka isha Sass ee faylalka CSS (oo ay ku jirto habkayaga dhismaha). Si aad ugu dhammaato isla CSS la soo saaray markaad Sass ururinayso adigoo isticmaalaya dhuumaha hantidaada, waxaad u baahan doontaa inaad isticmaasho isku xidhka Sass kaas oo taageera ugu yaraan sifooyinka uu sameeyo Node Sass. Tani waa muhiim in la ogaado sababtoo ah laga bilaabo Oktoobar 26, 2020, LibSass iyo baakadaha lagu dhisay dusheeda - oo ay ku jiraan Node Sass - waa la joojiyay .

Haddii aad u baahan tahay sifooyin Sass cusub ama ku habboonaanta heerarka cusub ee CSS, Dart Sass hadda waa hirgelinta aasaasiga ah ee Sass waxayna taageertaa JavaScript API kaas oo si buuxda ula jaan qaadaya Node Sass (iyadoo laga reebayo dhawr ka reeban oo ku qoran bogga GitHub ee Dart Sass ).

Waxaan u kordhinay saxnaanta Sass 6 (sida caadiga ah, waa 5 ee Node Sass) si aan uga hortagno arrimaha ku saabsan wareejinta browserka. Haddii aad isticmaasho Dart Sass tani ma noqon doonto wax aad u baahan tahay inaad hagaajiso, maadaama isku-dubariduhu isticmaalo saxnaanta 10 iyo sababaha hufnaanta awgeed ma ogola in la hagaajiyo.

Hor-fixiyaha

Bootstrap waxay isticmaashaa Autoprefixer (oo ay ku jirto habkayaga dhismaha) si uu si toos ah ugu daro horgalayaasha iibiyaha qaar ka mid ah guryaha CSS wakhtiga dhismaha. In sidaa la yeelo waxa ay ina badbaadisaa wakhtiga iyo koodka anaga oo noo ogolaanaysa in aan hal mar qorno qaybaha muhiimka ah ee CSS-keena inagoo meesha ka saarayna baahida loo qabo isku darka iibiyaha sida kuwa laga helay v3.

Waxaan ku haynaa liiska daalacashada ee lagu taageerayo Autoprefixer oo ku jira fayl gaar ah oo ku dhex jira kaydka GitHub. Faahfaahinta ka eeg .browserslistrc

Dukumeenti maxalli ah

Ku socodsiinta dukumentiyadayada gudaha waxay u baahan tahay isticmaalka Hugo, kaas oo lagu rakibay xirmada hugo-bin npm. Hugo waa koronto dhaliyaha goobta taagan si aad ah u degdega ah oo na siinaya: aasaasiga waxaa ka mid ah, Faylasha Markdown-ku-saleysan, qaab-qaabeeya, iyo in ka badan. Waa kan sida loo bilaabo:

  1. Ku dhex orod dejinta qalabka kor ku xusan si aad u rakibto dhammaan ku-tiirsanaanta.
  2. /bootstrapLaga soo bilaabo tusaha xididka , ku socodsii npm run docs-servekhadka taliska.
  3. Ka fur http://localhost:9001/browserkaaga, oo voilà.

Baro wax badan oo ku saabsan isticmaalka Hugo adiga oo akhrinaya dukumeentigeeda .

Ciladaynta

Haddii aad la kulanto dhibaatooyin ku saabsan rakibidda ku-tiirsanaanta, ka saar dhammaan noocyada ku-tiirsanaanta hore (caalami iyo maxalli). Kadibna, ku celi npm install.