in English

Smíða verkfæri

Lærðu hvernig á að nota Bootstrap meðfylgjandi npm forskriftir til að búa til skjöl okkar, setja saman frumkóða, keyra próf og fleira.

Uppsetning verkfæra

Bootstrap notar npm forskriftir fyrir byggingarkerfið sitt. Package.json okkar inniheldur þægilegar aðferðir til að vinna með rammanum, þar á meðal að setja saman kóða, keyra próf og fleira.

Til að nota byggingarkerfið okkar og keyra skjölin okkar á staðnum þarftu afrit af frumskrám Bootstrap og Node. Fylgdu þessum skrefum og þú ættir að vera tilbúinn til að rokka:

  1. Sæktu og settu upp Node.js , sem við notum til að stjórna ósjálfstæði okkar.
  2. Annaðhvort halaðu niður heimildum Bootstrap eða gafflaðu geymslu Bootstrap .
  3. Farðu í rótarskrána /bootstrapog keyrðu npm installtil að setja upp staðbundin ósjálfstæði okkar sem skráð eru í package.json .
  4. Settu upp Ruby , settu upp Bundler með gem install bundlerog keyrðu að lokum bundle install. Þetta mun setja upp öll Ruby ósjálfstæði, svo sem Jekyll og viðbætur.
    • Windows notendur: Lestu þessa handbók til að koma Jekyll í gang án vandræða.

Þegar því er lokið muntu geta keyrt hinar ýmsu skipanir sem gefnar eru upp frá skipanalínunni.

Notaðu npm forskriftir

Package.json okkar inniheldur eftirfarandi skipanir og verkefni:

Verkefni Lýsing
npm run dist npm run distbýr til /dist/möppuna með samsettum skrám. Notar Sass , Autoprefixer og terser .
npm test Sama og npm run distauk þess sem það keyrir prófanir á staðnum
npm run docs Byggir og fóðrar CSS og JavaScript fyrir skjöl. Þú getur síðan keyrt skjölin á staðnum í gegnum npm run docs-serve.

Hlaupa npm runtil að sjá öll npm forskriftirnar.

Autoprefixer

Bootstrap notar Autoprefixer (innifalið í byggingarferlinu okkar) til að bæta sjálfkrafa forskeytum söluaðila við sumar CSS eiginleika á byggingartíma. Með því að gera það sparar okkur tíma og kóða með því að leyfa okkur að skrifa lykilhluta CSS okkar einu sinni á sama tíma og útrýma þörfinni fyrir söluaðilablöndur eins og þær sem finnast í v3.

Við höldum listanum yfir vafra sem studdir eru í gegnum Autoprefixer í sérstakri skrá innan GitHub geymslunnar okkar. Sjá .browserslistrc fyrir frekari upplýsingar.

Staðbundin skjöl

Að keyra skjölin okkar á staðnum krefst notkunar á Jekyll, sæmilega sveigjanlegum kyrrstæðum vefsmiðjum sem veitir okkur: grunnatriði, Markdown-undirstaða skrár, sniðmát og fleira. Svona á að koma því af stað:

  1. Keyrðu í gegnum verkfærauppsetninguna hér að ofan til að setja upp Jekyll (síðugerðina) og önnur Ruby ósjálfstæði með bundle install.
  2. Frá rótarskránni /bootstrapskaltu keyra npm run docs-serveí skipanalínunni.
  3. Opnaðu http://localhost:9001í vafranum þínum og voilà.

Lærðu meira um notkun Jekyll með því að lesa skjöl þess .

Bilanagreining

Ef þú lendir í vandræðum með að setja upp ósjálfstæði skaltu fjarlægja allar fyrri útgáfur af ósjálfstæði (alheims og staðbundin). Síðan skaltu endursýna npm install.