in English

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. Basta i-download dagiti taudan ti Bootstrap wenno tinidor ti pagidulinan ti Bootstrap .
  3. Agturong iti ramut a /bootstrapdirektorio ken agtaray npm installtapno mangikabil kadagiti lokal a panagpanpanunotmi a nailista iti package.json .

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

Panagusar kadagiti npm nga iskrip

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

Tarabaho Panangiladawan
npm run dist npm run distmangparnuay ti /dist/direktorio nga addaan kadagiti naurnong a file. Usaren ti Sass , Autoprefixer , ken terser .
npm test Ipatarayenna dagiti panagsubok iti lokal kalpasan ti panagtaraynpm run dist
npm run docs-serve Mangbangon ken mangpataray ti dokumentasion iti lokal.

Agtaray npm runtapno makita amin nga npm scripts.

Rugian ti Bootstrap babaen ti npm babaen ti starter project mi! Agturong iti pagidulinan ti plantilia ti twbs/bootstrap-npm-starter tapno makita no kasano ti mangbangon ken mangpasayaat ti Bootstrap iti bukodmo a proyekto ti npm. Iramanna ti Sass a kompiler, Autoprefixer, Stylelint, PurgeCSS, ken dagiti Ikono ti Bootstrap.

Sass nga

Ti Bootstrap v4 ket agus-usar ti Node Sass para iti panagtipon kadagiti taudan a papelestayo ti Sass kadagiti papeles ti CSS (nairaman iti proseso ti panagbangontayo). Tapno agngudo iti isu met laeng a napataud a CSS no agtipon ti Sass babaen ti panagusar ti bukodmo a tubo ti sanikua, kasapulam ti agusar ti maysa a kompiler ti Sass a mangsuporta iti urayno bassit a tampok nga ar-aramiden ti Node Sass. Daytoy ket napateg a maipalagip gapu ta manipud idi Oktubre 26, 2020, ti LibSass ken dagiti pakete a naibangon iti rabawna—a mairaman ti Node Sass—ket saanen a maus- usar .

No kasapulam dagiti baro a tampok ti Sass wenno panagtunos kadagiti baro a pagalagadan ti CSS, ti Dart Sass ket isu itan ti kangrunaan a pannakaipatungpal ti Sass ken mangsuporta ti JavaScript API a naan-anay a maitunos iti Node Sass (nga addaan kadagiti sumagmamano a pannakailaksid a nailista iti panid ti GitHub ti Dart Sass ).

Paaduenmi ti kinaeksakto ti panagtimbukel ti Sass iti 6 (babaen ti default, 5 daytoy iti Node Sass) tapno malapdan dagiti isyu iti panagtimbukel ti browser. No usarem ti Dart Sass daytoy ket saan a maysa a banag a kasapulam nga ilinteg, a kas dayta a kompiler ket agus-usar ti panagtimbukel a presision iti 10 ken para kadagiti rason ti episiensiana ket saan a mangipalubos a daytoy ket maitunos.

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 a lokal ket agkasapulan ti panagusar ti Hugo, a makagun-od ti pannakaipasdek babaen ti pakete ti hugo-bin npm. Ti Hugo ket maysa a blazingly a napardas ken medyo mapalawa nga estatiko a site generator a mangipaay kadatayo: dagiti batayan a mairaman, dagiti Markdown-based a papeles, dagiti plantilia, ken dadduma pay. Kastoy no kasano a mairugi dayta:

  1. Ipataray babaen ti tooling setup iti ngato tapno mai-install amin a dependencies.
  2. Manipud iti root /bootstrapdirectory, tarayen npm run docs-serveiti linia ti bilin.
  3. Luktam http://localhost:9001/iti browser-mo, ken voilà.

Ammuem ti ad-adu pay maipapan iti panagusar ti Hugo 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 .