Source

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. Farðu í rótarskrána /bootstrapog keyrðu npm installtil að setja upp staðbundin ósjálfstæði okkar sem skráð eru í package.json .
  3. 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.

Notkun NPM forskrifta

Package.json okkar inniheldur eftirfarandi skipanir og verkefni:

Verkefni Lýsing
npm run dist npm run distbýr til /distmöppuna með samsettum skrám. Notar Sass , Autoprefixer og UglifyJS .
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.

We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See /package.json for details.

Local documentation

Running our documentation locally requires the use of Jekyll, a decently flexible static site generator that provides us: basic includes, Markdown-based files, templates, and more. Here’s how to get it started:

  1. Run through the tooling setup above to install Jekyll (the site builder) and other Ruby dependencies with bundle install.
  2. From the root /bootstrap directory, run npm run docs-serve in the command line.
  3. Open http://localhost:9001 in your browser, and voilà.

Learn more about using Jekyll by reading its documentation.

Troubleshooting

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.