Adeiladu offer
Dysgwch sut i ddefnyddio sgriptiau npm sydd wedi'u cynnwys gan Bootstrap i adeiladu ein dogfennaeth, llunio cod ffynhonnell, cynnal profion, a mwy.
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 rocio:
- Lawrlwythwch a gosodwch Node.js , a ddefnyddiwn i reoli ein dibyniaethau.
- Llywiwch i'r
/bootstrap
cyfeiriadur gwraidd a rhedegnpm install
i osod ein dibyniaethau lleol a restrir yn package.json . - Gosod Ruby , gosod Bundler gyda
gem install bundler
, ac yn olaf rhedegbundle 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.
Mae ein pecyn.json yn cynnwys y gorchmynion a'r tasgau canlynol:
Tasg | Disgrifiad |
---|---|
npm run dist |
npm run dist yn creu'r /dist cyfeiriadur gyda ffeiliau wedi'u llunio. Yn defnyddio Sass , Autoprefixer , ac UglifyJS . |
npm test |
Yn npm run dist ogystal 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 run
i weld yr holl sgriptiau npm.
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 /package.json am fanylion.
Er mwyn rhedeg ein dogfennaeth yn lleol mae angen defnyddio Jekyll, generadur safle sefydlog gweddol hyblyg sy'n darparu: sylfaenol yn cynnwys, ffeiliau yn seiliedig ar Markdown, templedi, a mwy. Dyma sut i roi cychwyn arni:
- Rhedwch trwy'r gosodiad offer uchod i osod Jekyll (adeiladwr y wefan) a dibyniaethau Ruby eraill gyda
bundle install
. /bootstrap
O'r cyfeiriadur gwraidd , rhedegnpm run docs-serve
yn y llinell orchymyn.- Agorwch
http://localhost:9001
yn eich porwr, a voilà.
Dysgwch fwy am ddefnyddio Jekyll trwy ddarllen ei ddogfennaeth .
Os cewch chi broblemau gyda gosod dibyniaethau, dadosodwch yr holl fersiynau dibyniaeth blaenorol (byd-eang a lleol). Yna, ailredwch npm install
.