Source

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. U gudub tusaha xididka /bootstrapoo orod npm installsi aad u rakibto ku-tiirsanaanta deegaanka ee ku taxan xirmada.json .
  3. Ku rakib Ruby , ku rakib Bundler , oo gem install bundlerugu dambeyntii socodsii bundle install. Tani waxay rakibi doontaa dhammaan ku-tiirsanaanta Ruby, sida Jekyll iyo plugins.
    • Isticmaalayaasha Windows: Akhri tilmaan -bixiyahan si aad Jekyll u kiciso oo u shaqeyso dhib la'aan.

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 UglifyJS .
npm test Si la mid ah npm run distplus waxay u qabataa imtixaanada gudaha
npm run docs Waxay u dhistaa oo dhejisaa CSS iyo JavaScript docs. Kadib waxaad ku socodsiin kartaa dukumentiyada gudaha adiga oo isticmaalaya npm run docs-serve.

Orod npm runsi aad u aragto dhammaan qoraallada npm

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 dukumeentiyadayada gudaha waxay u baahan tahay isticmaalka Jekyll, koronto dhaliye si fiican u dabacsan oo goobta na siinaya: aasaasiga waxaa ka mid ah, faylasha Markdown-ku-saleysan, qaab-dhismeedka, iyo in ka badan. Waa kan sida loo bilaabo:

  1. Ku dhex orod qalabaynta kor ku xusan si aad u rakibto Jekyll (dhisaha goobta) iyo ku-tiirsanaanta Ruby kale ee bundle install.
  2. /bootstrapLaga soo bilaabo tusaha xididka , ku socodsii npm run docs-servekhadka taliska.
  3. Ka fur http://localhost:9001browserkaaga, oo voilà.

Baro wax badan oo ku saabsan isticmaalka Jekyll 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.