U gudub nuxurka muhiimka ah U gudub dukumentiyada navigation
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.

Boggan

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

Xidhmadayada.json waxa ku jira hawlo badan oo lagu horumarinayo mashruuca. Orod npm runsi aad u aragto dhammaan qoraallada npm ee ku jira terminaalkaaga. Hawlaha aasaasiga ah waxaa ka mid ah:

Hawl Sharaxaada
npm start Wuxuu uruuriyaa CSS iyo JavaScript, wuxuu dhisaa dukumeentiyada, oo wuxuu bilaabaa server maxalli ah.
npm run dist Waxay ku abuurtaa dist/hagaha faylal la ururiyay. Wuxuu u baahan yahay 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.
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 waxay isticmaashaa Dart Sass si ay u ururiso faylalka isha Sass ee faylalka CSS (oo ay ku jiraan habka dhisitaanka), waxaanan kugula talinaynaa inaad sidaas oo kale samayso haddii aad ururinayso Sass adigoo isticmaalaya dhuumaha hantidaada. Waxaan horey ugu isticmaalnay Node Sass Bootstrap v4, laakiin LibSass iyo baakadaha lagu dhisay dusheeda, oo ay ku jiraan Node Sass, ayaa hadda la joojiyay .

Dart Sass waxay isticmaashaa saxnaanta wareega ee 10 iyo sababaha hufnaanta awgeed ma ogola hagaajinta qiimahan. Ma hoos u dhigno saxnaantan inta lagu jiro socodsiinta dheeraadka ah ee CSS-tayada la soo saaray, sida inta lagu jiro yaraynta, laakiin haddii aad dooratid inaad sidaas sameyso waxaan kugula talineynaa inaad ilaaliso saxnaanta ugu yaraan 6 si looga hortago arrimaha ku saabsan wareejinta browserka.

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

RTLCSS

Bootstrap waxay isticmaashaa RTLCSS si ay u habayso CSS-ga la soo ururiyey oo loogu beddelo RTL - asal ahaan beddelka guryaha toosan ee garashada (tusaale padding-left) iyaga oo ka soo horjeeda. Waxa ay noo ogolaataa in aan qorno CSS-kayaga hal mar oo aanu samayno tweaks yar annagoo adeegsanayna xakamaynta RTLCSS iyo dardaaranka qiimaha .

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.