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.

Iti daytoy a panid

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:

I-download ken i-install ti Node.js , nga usarentayo a mangituray kadagiti agpampannuraytayo.
Basta i-download dagiti taudan ti Bootstrap wenno tinidor ti pagidulinan ti Bootstrap .
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.jsonmi ket mangiraman kadagiti adu nga aramid para iti panangparang-ay ti proyekto. Agtaray npm runtapno makita amin dagiti npm script iti terminalmo. Dagiti kangrunaan nga aramid ket mairaman ti:

Tarabaho	Panangiladawan
`npm start`	Mangtipon ti CSS ken JavaScript, mangbangon ti dokumentasion, ken mangrugi ti lokal a serbidor.
`npm run dist`	Mangpartuat ti `dist/`direktorio nga addaan kadagiti naurnong a file. Kasapulan ti Sass , Autoprefixer , ken terser .
`npm test`	Ipatarayenna dagiti panagsubok iti lokal kalpasan ti panagtaray`npm run dist`
`npm run docs-serve`	Mangbangon ken mangpataray ti dokumentasion iti lokal.

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 ket agus-usar ti Dart Sass para iti panagtipon kadagiti taudan a papelesmi ti Sass kadagiti papeles ti CSS (nairaman iti proseso ti panagbangonmi), ken irekomendarmi nga aramidem ti isu met laeng no agtiponka ti Sass babaen ti panagusar ti bukodmo a tubo ti sanikua. Dati nga inus-usarmi ti Node Sass para iti Bootstrap v4, ngem ti LibSass ken dagiti pakete a naibangon iti rabawna, a mairaman ti Node Sass, ket saanen a maus- usar itan .

Ti Dart Sass ket agus-usar ti panagtimbukel a presision ti 10 ken para kadagiti rason ti episiensiana ket saan a mangipalubos ti panagbalbaliw iti daytoy a pateg. Saanmi nga ibaba daytoy a kinaeksakto bayat ti ad-adu pay a panagproseso ti napataud a CSSmi, a kas bayat ti panagpabassit, ngem no pinilim nga aramiden daytoy irekomendarmi ti panangtaginayon ti kinaeksakto iti saan a basbassit ngem 6 tapno malapdan dagiti isyu iti panagtimbukel ti browser.

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.

RTLCSS nga

Ti Bootstrap ket agus-usar ti RTLCSS tapno mangproseso ti naurnong a CSS ken mangbalbaliw kadagitoy iti RTL – a kangrunaan a mangsukat kadagiti horisontal a direksion a makaammo a tagikua (kas pagarigan padding-left) kadagiti kasumbangirda. Daytoy ket mangipalubos kadakami laeng nga agsurat ti CSSmi iti maymaysa a panawen ken mangaramid kadagiti babassit a panagbalbaliw babaen ti panagusar kadagiti direktiba ti panagtengngel ken pateg ti RTLCSS.

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:

Ipataray babaen ti tooling setup iti ngato tapno mai-install amin a dependencies.
Manipud iti root /bootstrapdirectory, tarayen npm run docs-serveiti linia ti bilin.
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 .