in English

Gurallary gurmak

Resminamalarymyzy gurmak, deslapky kody düzmek, synaglary geçirmek we başgalar üçin Bootstrap-yň goşulan npm skriptlerini nähili ulanmalydygyny öwreniň.

Gural gurmak

“ Bootstrap ” gurmak ulgamy üçin npm skriptlerini ulanýar. Package.json , çarçuwa bilen işlemek üçin amatly usullary, şol sanda kod düzmek, synag synaglary we ş.m. öz içine alýar .

Gurluşyk ulgamymyzy ulanmak we resminamalarymyzy ýerli derejede işletmek üçin Bootstrap-yň deslapky faýllarynyň we düwünleriniň bir nusgasy gerek bolar. Bu ädimleri ýerine ýetiriň we daşlaşmaga taýyn bolmaly:

  1. Baglylyklarymyzy dolandyrmak üçin ulanýan Node.js-i göçürip alyň .
  2. Bootstrap çeşmelerini göçürip alyň ýa -da Bootstrap ammaryny göçürip alyň .
  3. /bootstrapKök katalogyna geçiň we package.jsonnpm install -da görkezilen ýerli garaşlylyklarymyzy gurmak üçin işlediň .

Gutaransoň, buýruk setirinden berlen dürli buýruklary işledip bilersiňiz.

Npm skriptlerini ulanmak

Package.json aşakdaky buýruklary we meseleleri öz içine alýar :

Wezipe Düşündiriş
npm run dist npm run dist/dist/düzülen faýllar bilen katalogy döredýär . Sass , Autoprefixer we terser ulanýar .
npm test Işledilenden soň ýerli synaglary geçirýärnpm run dist
npm run docs-serve Resminamalary ýerli derejede gurýar we işleýär.

npm runNpm skriptleriniň hemmesini görmek üçin ylgaň .

Başlangyç taslamamyz bilen npm arkaly Bootstrap bilen başlaň! Bootstrap-y öz npm proýektiňizde nädip gurmalydygyny we sazlamalydygyny görmek üçin twbs / bootstrap-npm-starter şablon ammaryna başlaň. Sass düzüjisi, Autoprefixer, Stylelint, PurgeCSS we Bootstrap nyşanlaryny öz içine alýar.

Sass

Bootstrap v4 , Sass çeşme faýllarymyzy CSS faýllaryna düzmek üçin “ Node Sass ” -y ulanýar (gurluşyk işimize girýär). Öz aktiw turbageçirijiňiz bilen Sass düzülende şol bir döredilen CSS bilen gutarmak üçin, iň bolmanda Node Sass-yň edýän aýratynlyklaryny goldaýan Sass düzüjisini ulanmaly bolarsyňyz. Muny bellemelidiris, sebäbi 2020-nji ýylyň 26-njy oktýabryna çenli LibSass we üstünde gurlan paketler, şol sanda Node Sass-da köne .

Has täze Sass aýratynlyklaryny ýa-da täze CSS ülňülerine laýyklygy talap edýän bolsaňyz, Dart Sass indi Sass-yň esasy ýerine ýetirilişi bolup, Node Sass bilen doly gabat gelýän JavaScript API-ni goldaýar (Dart Sassyň GitHub sahypasynda görkezilen birnäçe kadadan çykmalar bilen ).

Brauzeriň tegelek bolmagy bilen baglanyşykly meseleleriň öňüni almak üçin Sass tegelek takyklygyny 6-a çenli ýokarlandyrýarys (deslapky görnüşde, Node Sass-da 5). “Dart Sass” -y ulansaňyz, bu düzetmeli zat bolmaz, sebäbi düzüjiniň 10 tegelek takyklygy ulanylýar we netijelilik sebäpli ony sazlamaga mümkinçilik bermeýär.

Awtofrefikser

“ Bootstrap ” “ Autoprefixer ” -i (gurluşyk işimize girýär) satyjy prefikslerini gurmak wagtynda käbir CSS häsiýetlerine awtomatiki goşmak üçin ulanýar. Şeýle etmek, vS-de tapylanlar ýaly satyjy garyndylara bolan zerurlygy aradan aýyrmak bilen CSS-iň esasy böleklerini bir gezek ýazmaga mümkinçilik bermek bilen wagt we kod tygşytlaýar.

Autoprefixer arkaly goldanýan brauzerleriň sanawyny GitHub ammarymyzdaky aýratyn faýlda saklaýarys. Jikme-jiklikler üçin .browserslistrc serediň .

Localerli resminamalar

Resminamalarymyzy ýerli derejede işletmek, hugo-bin npm paketiniň üsti bilen gurnalan Hugo-ny ulanmagy talap edýär . Gýugo, bize hödürleýän çalt we giňelip bilýän statiki saýt generatory: esasy, Markdown esasly faýllar, şablonlar we ş.m. Ine, nädip başlamaly:

  1. Dependhli baglylyklary gurmak üçin ýokardaky gurallar guralyny işlediň .
  2. Kök katalogyndan buýruk setirinde /bootstrapişlediň .npm run docs-serve
  3. http://localhost:9001/Brauzeriňizde açyň we voilà.

Gýugo resminamalaryny okamak bilen has giňişleýin öwreniň .

Näsazlyklary düzeltmek

Baglanyşyklary gurmak bilen baglanyşykly kynçylyklar bilen ýüzbe-ýüz bolsaňyz, öňki garaşlylyk wersiýalaryny (global we ýerli) aýyryň. Soňra täzeden işlediň npm install.