Source

Mangbangon kadagiti ramit

Ammuem no kasano nga usaren dagiti nairaman nga iskrip ti npm ti Bootstrap tapno mangbangon ti dokumentasiontayo, mangtipon iti taudan a kodigo, mangpataray kadagiti panagsubok, ken dadduma pay.

Panangisaad ti remienta

Ti Bootstrap ket agus-usar kadagiti NPM nga iskrip para iti sistema ti panagbangonna. Ti package.json mi ket mangiraman kadagiti kombeniente a pamay-an para iti panagtrabaho iti balangkas, a mairaman ti panagtipon ti kodigo, panagtaray kadagiti panagsubok, ken dadduma pay.

Tapno mausar ti sistema ti panagbangonmi ken mapataray ti dokumentasionmi a lokal, kasapulam ti kopia dagiti taudan a file ken Node ti Bootstrap. Surotem dagitoy nga addang ket rumbeng a nakasaganaka nga ag-rock:

  1. I-download ken i-install ti Node.js , nga usarentayo a mangituray kadagiti agpampannuraytayo.
  2. Agturong iti ramut a /bootstrapdirektorio ken agtaray npm installtapno mangikabil kadagiti lokal a panagpanpanunotmi a nailista iti package.json .
  3. I-install ti Ruby , i-install ti Bundler nga addaan gem install bundler, ken kamaudiananna ipatarayen bundle install. Daytoy ket mangikabil kadagiti amin a panagpanpanunot ti Ruby, a kas ti Jekyll ken dagiti plugin.
    • Dagiti agar-aramat iti Windows: Basaen daytoy a giya tapno makapataray ti Jekyll nga awan ti problema.

No malpas, mabalinmon nga ipatarayen dagiti nadumaduma a bilin a naited manipud iti linia ti bilin.

Panangusar kadagiti iskrip ti NPM

Ti package.json mi ket mangiraman kadagiti sumaganad a bilin ken trabaho:

Tarabaho Panangiladawan
npm run dist npm run distmangparnuay ti /distdirektorio nga addaan kadagiti naurnong a file. Usaren ti Sass , Autoprefixer , ken UglifyJS .
npm test Same as npm run distplus daytoy ket mangpataray kadagiti panagsubok iti lokal
npm run docs Mangbangon ken manglint ti CSS ken JavaScript para kadagiti dok. Kalpasanna mabalinmo nga ipatarayen ti dokumentasion iti lokal babaen ti npm run docs-serve.

Agtaray npm runtapno makita amin nga npm scripts.

Autoprefixer nga

Ti Bootstrap ket agus-usar ti Autoprefixer (nairaman iti proseso ti panagbangonmi) tapno automatiko a manginayon kadagiti prefix ti aglaklako kadagiti sumagmamano a tagikua ti CSS iti oras ti panagbangon. Ti panangaramid iti daytoy ket makasalbar kadatayo ti panawen ken kodigo babaen ti panangipalubos kadatayo a mangisurat kadagiti kangrunaan a paset ti CSStayo iti maymaysa a gundaway bayat a mangikkat ti panagkasapulan kadagiti vendor mixins a kas dagitoy a masarakan iti v3.

Mantenerenmi ti listaan ​​dagiti browser a nasuportaran babaen ti Autoprefixer iti naisina a file iti uneg ti pagidulinanmi iti GitHub. Kitaen ti /.browserslistrc para kadagiti detalye.

Lokal a dokumentasion

Ti panagtaray ti dokumentasionmi iti lokal ket agkasapulan ti panagusar ti Jekyll, ti disente a nalaka a maibagay nga estatiko a site generator a mangipaay kadakami: dagiti batayan a mairaman, dagiti Markdown-a naibatay a papeles, dagiti plantilia, ken dadduma pay. Kastoy no kasano a mairugi dayta:

  1. Ipataray babaen ti panagisaad ti ramit iti ngato tapno mangikabil ti Jekyll (ti managibangon ti site) ken dagiti dadduma pay a panagpanpanunot ti Ruby nga addaan iti bundle install.
  2. Manipud iti root /bootstrapdirectory, tarayen npm run docs-serveiti linia ti bilin.
  3. Luktam http://localhost:9001iti browser-mo, ken voilà.

Ammuem ti ad-adu pay maipapan iti panagusar ti Jekyll babaen ti panangbasa iti dokumentasionna .

Panagsolbar ti Problema

No rumbeng a makasabetka kadagiti parikut iti panagikabil kadagiti panagpanpanunot, i-uninstall amin dagiti napalabas a bersion ti panagpanpanunot (global ken lokal). Kalpasanna, ipabuya manen npm installti .