in English

Uirlisí a thógáil

Faigh amach conas scripteanna npm san áireamh Bootstrap a úsáid chun ár gcáipéisíocht a thógáil, cód foinse a thiomsú, tástálacha a rith, agus go leor eile.

Socrú uirlisí

Úsáideann Bootstrap scripteanna npm dá chóras tógála. Áiríonn ár package.json modhanna áisiúla chun oibriú leis an gcreat, lena n-áirítear cód a thiomsú, tástálacha a rith, agus go leor eile.

Chun ár gcóras tógála a úsáid agus ár ndoiciméadú a rith go háitiúil, beidh cóip de bhunchomhaid Bootstrap agus Node uait. Lean na céimeanna seo agus ba chóir duit a bheith réidh le carraig:

  1. Íoslódáil agus suiteáil Node.js , a úsáidimid chun ár spleáchais a bhainistiú.
  2. Déan foinsí Bootstrap a íoslódáil nó forc ar stór Bootstrap .
  3. Déan nascleanúint chuig an /bootstrapeolaire fréimhe agus rith npm installchun ár spleáchais áitiúla atá liostaithe i package.json a shuiteáil .

Nuair a bheidh tú críochnaithe, beidh tú in ann na horduithe éagsúla a sholáthraítear ón líne ordaithe a rith.

Ag baint úsáide as scripteanna npm

Áiríonn ár pack.json na horduithe agus na tascanna seo a leanas:

Tasc Cur síos
npm run dist npm run distcruthaíonn sé an t- /dist/eolaire le comhaid tiomsaithe. Úsáideann sé Sass , Uathréimseoir , agus terser .
npm test Ritheann tástálacha go háitiúil tar éis rithnpm run dist
npm run docs-serve Tógann agus ritheann na doiciméid go háitiúil.

Rith npm runchun na scripteanna npm go léir a fheiceáil.

Cuir tús le Bootstrap trí npm lenár dtionscadal tosaithe! Téigh go dtí an stór teimpléad twbs/bootstrap-npm-starter chun féachaint conas Bootstrap a thógáil agus a shaincheapadh i do thionscadal npm féin. Áirítear leis na deilbhíní tiomsaitheoir Sass, Autoprefixer, Stylelint, PurgeCSS agus Bootstrap.

Sass

Úsáideann Bootstrap v4 Node Sass chun ár gcomhaid fhoinse Sass a thiomsú i gcomhaid CSS (san áireamh inár bpróiseas tógála). Chun deireadh a chur leis an CSS ginte céanna agus Sass á thiomsú ag baint úsáide as do phíblíne sócmhainní féin, beidh ort tiomsaitheoir Sass a úsáid a thacaíonn ar a laghad na gnéithe a dhéanann Node Sass. Tá sé seo tábhachtach a thabhairt faoi deara mar ó 26 Deireadh Fómhair, 2020, tá LibSass agus pacáistí a tógadh ar a bharr - lena n-áirítear Node Sass - i léig .

Má theastaíonn gnéithe Sass níos nuaí uait nó comhoiriúnacht le caighdeáin CSS níos nuaí, is é Dart Sass príomh-chur chun feidhme Sass anois agus tacaíonn sé le JavaScript API atá comhoiriúnach go hiomlán le Node Sass (le roinnt eisceachtaí liostaithe ar leathanach GitHub Dart Sass ).

Méadóimid beachtas slánaithe Sass go 6 (de réir réamhshocraithe, is é 5 in Node Sass é) chun saincheisteanna le slánú brabhsálaí a chosc. Má úsáideann tú Dart Sass ní bheidh ort é seo a choigeartú, mar go n-úsáideann an tiomsaitheoir sin cruinneas slánaithe de 10 agus ar chúiseanna éifeachtúlachta ní cheadaíonn sé é a choigeartú.

Uathréimír

Úsáideann Bootstrap Autoprefixer (san áireamh inár bpróiseas tógála) chun réimíreanna díoltóirí a chur go huathoibríoch le roinnt maoine CSS ag am tógála. Sábhálann sé sin am agus cód dúinn trí ligean dúinn codanna tábhachtacha dár CSS a scríobh aon am amháin agus deireadh a chur leis an ngá atá le meascáin díoltóirí cosúil leis na cinn atá le fáil in v3.

Coimeádaimid liosta na mbrabhsálaithe a dtacaítear leo trí Autoprefixer i gcomhad ar leith laistigh dár stór GitHub. Féach .browserslistrc le haghaidh sonraí.

Doiciméadúchán áitiúil

Chun ár gcáipéisíocht a rith go háitiúil ní mór úsáid a bhaint as Hugo, a shuiteálfar tríd an bpacáiste Hugo-bin npm. Is gineadóir láithreáin statach blazingly tapa agus an-sínte é Hugo a sholáthraíonn dúinn: Áirítear bunúsach, comhaid bunaithe ar Markdown, teimpléid, agus go leor eile. Seo conas é a thosú:

  1. Rith tríd an socrú uirlisí thuas chun gach spleáchas a shuiteáil.
  2. Ón eolaire fréimhe /bootstrap, reáchtáil npm run docs-servesa líne ordaithe.
  3. Oscail http://localhost:9001/i do bhrabhsálaí, agus voilà.

Léigh tuilleadh faoi Hugo a úsáid ach a dhoiciméadú a léamh .

Fabhtcheartú

Má bhíonn fadhbanna agat le suiteáil spleáchais, díshuiteáil gach leagan spleáchais roimhe seo (domhanda agus áitiúil). Ansin, athrith npm install.