Téigh ar aghaidh chuig an bpríomhábhar Scipeáil chuig nascleanúint docs
Check

Cabhraigh linn Bootstrap a fhorbairt lenár gcuid scripteanna agus trialacha tógála doiciméad.

Socrú uirlisí

Úsáideann Bootstrap scripteanna npm chun an doiciméadú a thógáil agus chun comhaid foinse a thiomsú. Tá na scripteanna seo ag ár package.json chun cód a thiomsú, tástálacha a rith, agus go leor eile. Níl siad seo beartaithe le húsáid lasmuigh dár stór agus dár gcáipéisíocht.

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 package.json go leor tascanna chun an tionscadal a fhorbairt. Rith npm runchun na scripteanna npm go léir a fheiceáil i do chríochfort. I measc na bpríomhthascanna tá:

Tasc Cur síos
npm start Tiomsaíonn CSS agus JavaScript, tógann sé na doiciméid, agus cuireann sé tús le freastalaí áitiúil.
npm run dist Cruthaíonn an 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.
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 Dart Sass chun ár gcomhaid fhoinse Sass a thiomsú i gcomhaid CSS (san áireamh inár bpróiseas tógála), agus molaimid duit an rud céanna a dhéanamh má tá Sass á thiomsú agat ag baint úsáide as do phíblíne sócmhainní féin. D’úsáideamar Node Sass do Bootstrap v4 roimhe seo, ach tá LibSass agus pacáistí a tógadh ar a bharr, lena n-áirítear Node Sass, imithe i léig anois .

Úsáideann Dart Sass cruinneas slánaithe de 10 agus ar chúiseanna éifeachtúlachta ní cheadaíonn sé an luach seo a choigeartú. Ní laghdaítear an cruinneas seo le linn tuilleadh próiseála ar ár CSS ginte, mar le linn mionúcháin, ach má roghnaíonn tú é sin a dhéanamh molaimid beachtas de 6 ar a laghad a choinneáil chun fadhbanna le slánú brabhsálaí a chosc.

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í.

RTLCSS

Úsáideann Bootstrap RTLCSS chun CSS tiomsaithe a phróiseáil agus chun iad a thiontú go RTL – go bunúsach ag cur in ionad na n-airíonna atá feasach ar threo cothrománach (m.sh. padding-left) lena mhalairt. Ligeann sé dúinn ár CSS a scríobh ach am amháin agus mionathruithe a dhéanamh ag baint úsáide as treoracha rialaithe agus luacha RTLCSS .

Doiciméadúchán áitiúil

Chun ár gcáipéisíocht a rith go háitiúil ní mór Hugo a úsáid, 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.