U gudub nuxurka muhiimka ah U gudub dukumentiyada navigation
Check
in English

Wax ku darso

Ka caawi horumarinta Bootstrap qoraaladayada iyo imtixaanada lagu dhisayo dukumeentiyada.

Boggaan

Habaynta qalabka

Bootstrap waxay isticmaashaa qoraallada npm si ay u dhisto dukumeentiga oo ay u ururiyaan faylalka isha. Xidhmadayada.json waxay haysaa qoraalladan loogu talagalay ururinta koodka, imtixaannada socodsiinta, iyo in ka badan. Kuwan looguma talagelin in lagu isticmaalo meel ka baxsan kaydkayaga iyo dukumentiyadayada.

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 ururiyaa CSS iyo JavaScript, dhistaa dukumeentiyada, oo uu bilaabo server maxalli ah.
npm run dist Waxay ku abuurtaa dist/hagaha faylal la ururiyay. 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.
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 sass compiler, Autoprefixer, Stylelint, PurgeCSS, iyo Bootstrap Icons.

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 anagoo noo ogolaanayna in aan hal mar qorno qaybaha muhiimka ah ee CSS-keena annagoo meesha ka saarayna baahida loo qabo isku darka iibiyaha sida kuwa ku jira v3.

Waxaan ku haynaa liiska daalacashada ee lagu taageeray Autoprefixer 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 garanaya (tusaale padding-left) 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, faylalka Markdown-ku-saleysan, qaab-dhismeedka, 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.