Source

Adeiladu offer

Dysgwch sut i ddefnyddio sgriptiau npm wedi'u cynnwys gan Bootstrap i adeiladu ein dogfennaeth, llunio cod ffynhonnell, cynnal profion, a mwy.

Gosodiad offer

Mae Bootstrap yn defnyddio sgriptiau npm ar gyfer ei system adeiladu. Mae ein pecyn.json yn cynnwys dulliau cyfleus ar gyfer gweithio gyda'r fframwaith, gan gynnwys llunio cod, rhedeg profion, a mwy.

I ddefnyddio ein system adeiladu a rhedeg ein dogfennaeth yn lleol, bydd angen copi o ffeiliau ffynhonnell Bootstrap a Node arnoch. Dilynwch y camau hyn a dylech fod yn barod i siglo:

  1. Lawrlwythwch a gosodwch Node.js , a ddefnyddiwn i reoli ein dibyniaethau.
  2. Llywiwch i'r /bootstrapcyfeiriadur gwraidd a rhedeg npm installi osod ein dibyniaethau lleol a restrir yn package.json .
  3. Gosod Ruby , gosod Bundler gyda gem install bundler, ac yn olaf rhedeg bundle install. Bydd hyn yn gosod holl ddibyniaethau Ruby, megis Jekyll ac ategion.
    • Defnyddwyr Windows: Darllenwch y canllaw hwn i gael Jekyll ar waith heb broblemau.

Ar ôl ei gwblhau, byddwch yn gallu rhedeg y gwahanol orchmynion a ddarperir o'r llinell orchymyn.

Defnyddio sgriptiau npm

Mae ein pecyn.json yn cynnwys y gorchmynion a'r tasgau canlynol:

Tasg Disgrifiad
npm run dist npm run distyn creu'r /dist/cyfeiriadur gyda ffeiliau wedi'u llunio. Yn defnyddio Sass , Autoprefixer , ac UglifyJS .
npm test Yn npm run distogystal mae'n rhedeg profion yn lleol
npm run docs Yn adeiladu ac yn lintio CSS a JavaScript ar gyfer dogfennau. Yna gallwch redeg y ddogfennaeth yn lleol trwy npm run docs-serve.

Rhedeg npm runi weld yr holl sgriptiau npm.

Autoprefixer

Mae Bootstrap yn defnyddio Autoprefixer (wedi'i gynnwys yn ein proses adeiladu) i ychwanegu rhagddodiaid gwerthwyr yn awtomatig i rai eiddo CSS ar amser adeiladu. Mae gwneud hynny yn arbed amser a chod i ni trwy ganiatáu i ni ysgrifennu rhannau allweddol o'n CSS un tro tra'n dileu'r angen am gymysgeddau gwerthwyr fel y rhai a geir yn v3.

Rydym yn cynnal y rhestr o borwyr a gefnogir trwy Autoprefixer mewn ffeil ar wahân yn ein cadwrfa GitHub. Gweler .browserslistrc am fanylion.

Dogfennaeth leol

Er mwyn rhedeg ein dogfennaeth yn lleol mae angen defnyddio Jekyll, generadur safle sefydlog gweddol hyblyg sy'n darparu: sylfaenol yn cynnwys, ffeiliau sy'n seiliedig ar Markdown, templedi, a mwy. Dyma sut i roi cychwyn arni:

  1. Rhedwch trwy'r gosodiad offer uchod i osod Jekyll (adeiladwr y wefan) a dibyniaethau Ruby eraill gyda bundle install.
  2. /bootstrapO'r cyfeiriadur gwraidd , rhedeg npm run docs-serveyn y llinell orchymyn.
  3. Agorwch http://localhost:9001yn eich porwr, a voilà.

Dysgwch fwy am ddefnyddio Jekyll trwy ddarllen ei ddogfennaeth .

Datrys problemau

Os cewch chi broblemau gyda gosod dibyniaethau, dadosodwch yr holl fersiynau dibyniaeth blaenorol (byd-eang a lleol). Yna, ail-redeg npm install.