Biçe ser naveroka sereke Biçe navîgasyon belgeyan
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 ku girêdanên xwe birêve bibin.
  2. An çavkaniyên Bootstrap dakêşînin an jî depoya Bootstrap-ê dakêşînin .
  3. /bootstrapBigerin pelrêça root û birevin npm installda ku girêdanên me yên herêmî yên ku di pakêtê.json de hatine navnîş kirin saz bikin .

Dema ku qediya, hûn ê bikaribin 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 ji bo pêşvebirina projeyê gelek karan vedihewîne. Birevin npm runda ku hemî nivîsarên npm di termînala xwe de bibînin. Karên bingehîn ev in:

Karî Terîf
npm start CSS û JavaScript berhev dike, belgeyê ava dike û serverek herêmî dest pê dike.
npm run dist dist/Peldanka bi pelên berhevkirî diafirîne . Sass , Autoprefixer , û terser hewce dike .
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.
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 Dart Sass bikar tîne ji bo berhevkirina pelên meya çavkaniya Sass di pelên CSS de (di nav pêvajoya avakirina me de ye), û em ji we re pêşniyar dikin ku hûn heman yekê bikin ger hûn Sass-ê bi karanîna lûleya maliyeta xwe berhev dikin. Me berê Node Sass ji bo Bootstrap v4 bikar anî, lê LibSass û pakêtên ku li ser wê hatine çêkirin, tevî Node Sass, naha hatine betal kirin .

Dart Sass rastbûnek dorpêk a 10 bikar tîne û ji ber sedemên karîgeriyê rê nade verastkirina vê nirxê. Em di dema pêvajoyek din a CSS-ya xweya hilberandî de, wek mînak di dema kêmkirinê de, vê rastbûnê kêm nakin, lê heke we wiya hilbijart, em pêşniyar dikin ku bi kêmî ve 6 hûrgulî biparêzin da ku pêşî li pirsgirêkên dorpêkirina gerokê bigirin.

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.

RTLCSS

Bootstrap RTLCSS -ê bikar tîne da ku CSS-ya berhevkirî bişopîne û wan biguheze RTL - di bingeh de taybetmendiyên haydar ên rêwerziya horizontî (mînak. padding-left) bi dijberiya wan diguhezîne. Ew dihêle ku em tenê carek CSS-ya xwe binivîsin û bi karanîna rêwerzên kontrol û nirxê RTLCSS veguheztinên piçûk bikin .

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.