in English

Amûran ava bikin

Fêr bibin ka meriv çawa skrîptên npm yên Bootstrap-ê bikar tîne da ku belgeyên me ava bikin, koda çavkaniyê berhev bikin, ceribandinan bimeşînin, û hêj bêtir.

Sazkirina amûran

Bootstrap ji bo pergala avakirina xwe nivîsarên npm bikar tîne. Package.json me ji bo xebata bi çarçoweyê re rêbazên hêsan vedihewîne, tevî berhevkirina kodê, ceribandinên xebitandinê, û hêj bêtir.

Ji bo ku pergala avakirina me bikar bînin û belgeyên me li herêmî bimeşînin, hûn ê hewceyê kopiyek pelên çavkaniya Bootstrap û Node bin. Van gavan bişopînin û divê hûn amade bin ku rok bikin:

  1. Dakêşin û saz bikin Node.js , ku em bikar tînin ji bo birêvebirina girêdanên xwe.
  2. An çavkaniyên Bootstrap dakêşînin an jî depoya Bootstrap-ê dakêşînin .
  3. /bootstrapBigerin pelrêça root û birevin npm installda ku girêdayiyên me yên herêmî yên ku di pakêtê.json de hatine navnîş kirin saz bikin .

Dema ku qediya, hûn ê karibin fermanên cihêreng ên ku ji rêzika fermanê têne peyda kirin bimeşînin.

Bikaranîna nivîsarên npm

package.json me ferman û peywirên jêrîn vedihewîne:

Karî Terîf
npm run dist npm run dist/dist/pelrêça bi pelên berhevkirî diafirîne . Sass , Autoprefixer , û terser bikar tîne .
npm test Piştî xebitandinê testên herêmî dimeşînenpm run dist
npm run docs-serve Belgeyên herêmî ava dike û dimeşîne.

Birevin npm runda ku hemî nivîsarên npm bibînin.

Bi projeya meya destpêkê re bi npm bi Bootstrap dest pê bikin! Serê depoya şablonê twbs/bootstrap-npm-starter bidin ku hûn bibînin ka meriv çawa di projeya xweya npm de Bootstrap-ê ava dike û xweş dike. Berhevkarê Sass, Autoprefixer, Stylelint, PurgeCSS, û îkonên Bootstrap vedihewîne.

Sass

Bootstrap v4 Node Sass -ê bikar tîne ji bo berhevkirina pelên meya çavkaniya Sass di pelên CSS-ê de (di pêvajoya avakirina me de ye). Ji bo ku hûn dema ku Sass bi karanîna lûleya sermayeya xwe berhev dikin bi heman CSS-ya hatî hilberandin bi dawî bibin, hûn ê hewce bikin ku berhevkarek Sass bikar bînin ku bi kêmî ve taybetmendiyên ku Node Sass dike piştgirî dike. Ev girîng e ku were zanîn ji ber ku ji 26ê Cotmeha, 2020-an pê ve, LibSass û pakêtên ku li ser wê hatine çêkirin - tevî Node Sass - hatine xera kirin .

Heke hûn hewceyê taybetmendiyên nû yên Sass an lihevhatina bi standardên CSS-ê yên nûtir in, Dart Sass naha pêkanîna bingehîn a Sass e û piştgirî dide API-ya JavaScript ku bi Node Sass-ê re bi tevahî lihevhatî ye (bi çend îstîsnayên ku li ser rûpela GitHub ya Dart Sass têne navnîş kirin ).

Em rastbûna dorpêkirina Sass li 6 zêde dikin (ji hêla xwerû, ew di Node Sass de 5 e) da ku pêşî li pirsgirêkên dorpêkirina gerokê bigire. Ger hûn Dart Sass bikar bînin ev ê ne tiştek be ku hûn hewce ne ku hûn sererast bikin, ji ber ku ew berhevkar rastiyek dorpêvekirina 10-ê bikar tîne û ji ber sedemên karîgeriyê rê nade ku ew were sererast kirin.

Autoprefixer

Bootstrap Autoprefixer (di pêvajoya avakirina me de tê de) bikar tîne da ku di dema çêkirinê de pêşgiriyên firoşkar bixweber li hin taybetmendiyên CSS zêde bike. Bi kirina vê yekê rê dide me ku em beşên sereke yên CSS-a xwe yek carek binivîsin û di heman demê de hewcedariya mîksên firoşkar ên mîna yên ku di v3 de têne dîtin ji holê rakin, dem û kodê me xilas dike.

Em navnîşa gerokên ku bi Autoprefixer ve têne piştgirî kirin di pelek cûda de di nav depoya xweya GitHub de diparêzin. Ji bo hûragahiyan li .browserslistrc binêre.

Belgeyên herêmî

Rêvekirina belgeyên me yên herêmî hewceyê karanîna Hugo ye, ku bi pakêta hugo-bin npm ve tê saz kirin. Hugo jeneratorek malpera statîk a bi lez û bez berbelav e ku ji me re peyda dike: tê de bingehîn, pelên Markdown-based, şablon, û hêj bêtir. Li vir e ku meriv wê çawa dest pê bike:

  1. Sazkirina amûrkirinê ya li jor bimeşînin da ku hemî pêwendiyan saz bikin.
  2. /bootstrapJi pelrêça root , npm run docs-servedi rêzika fermanê de bimeşînin.
  3. http://localhost:9001/Di geroka xwe de vekin , û deng bikin.

Di derbarê karanîna Hugo de bi xwendina belgeyên wê bêtir fêr bibin .

Çareserkirina pirsgirêkan

Ger hûn di sazkirina pêwendiyan de bi pirsgirêkan re rû bi rû bimînin, hemî guhertoyên pêwendiyê yên berê (gerdûnî û herêmî) rakin. Piştre, dubare npm installbikin.