Ale nan kontni prensipal la Ale nan navigasyon dokiman yo
in English

Bati zouti

Aprann kijan pou itilize scripts npm Bootstrap yo pou konstwi dokiman nou yo, konpile kòd sous, fè tès yo, ak plis ankò.

Nan paj sa a

Konfigirasyon zouti

Bootstrap itilize scripts npm pou sistèm bati li yo. Package.json nou an gen ladan metòd pratik pou travay ak kad la, tankou konpile kòd, fè tès, ak plis ankò.

Pou itilize sistèm konstriksyon nou an epi kouri dokiman nou an lokalman, w ap bezwen yon kopi dosye sous Bootstrap ak Node. Swiv etap sa yo epi ou ta dwe pare pou rock:

  1. Telechaje epi enstale Node.js , ke nou itilize pou jere depandans nou yo.
  2. Swa telechaje sous Bootstrap oswa fouchèt depo Bootstrap la .
  3. /bootstrapNavige nan anyè rasin lan epi kouri npm installenstale depandans lokal nou yo ki nan lis nan package.json .

Lè w fini, ou pral kapab kouri kòmandman divès kalite yo bay nan liy lòd la.

Sèvi ak scripts npm

Package.json nou an gen ladan anpil travay pou devlope pwojè a. Kouri npm runpou wè tout scripts npm nan tèminal ou a. Travay prensipal yo enkli:

Travay Deskripsyon
npm start Konpile CSS ak JavaScript, bati dokiman an, epi kòmanse yon sèvè lokal.
npm run dist Kreye dist/anyè a ak dosye konpile. Mande Sass , Autoprefixer , ak terser .
npm test Kouri tès lokalman apre kourinpm run dist
npm run docs-serve Bati epi kouri dokiman an lokalman.
Kòmanse ak Bootstrap atravè npm ak pwojè starter nou an! Ale nan depo modèl twbs/bootstrap-npm-starter pou wè ki jan yo bati ak Customize Bootstrap nan pwòp pwojè npm ou. Gen ladann Sass du, Autoprefixer, Stylelint, PurgeCSS, ak Bootstrap Icons.

Sass

Bootstrap sèvi ak Dart Sass pou konpile dosye sous Sass nou yo nan dosye CSS (ki enkli nan pwosesis konstriksyon nou an), epi nou rekòmande ou fè menm bagay la si w ap konpile Sass lè l sèvi avèk pwòp tiyo avantaj ou. Nou te deja itilize Node Sass pou Bootstrap v4, men LibSass ak pakè ki bati sou li, ki gen ladan Node Sass, yo kounye a demode .

Dart Sass sèvi ak yon presizyon awondi nan 10 epi pou rezon efikasite pa pèmèt ajisteman nan valè sa a. Nou pa bese presizyon sa a pandan plis pwosesis CSS nou yo pwodwi, tankou pandan minifikasyon, men si ou chwazi fè sa, nou rekòmande pou kenbe yon presizyon nan omwen 6 pou anpeche pwoblèm ak awondi navigatè.

Otoprefiksè

Bootstrap itilize Autoprefixer (ki enkli nan pwosesis konstriksyon nou an) pou ajoute otomatikman prefiks machann nan kèk pwopriyete CSS nan moman konstriksyon. Lè w fè sa, sa fè nou sove tan ak kòd lè nou pèmèt nou ekri pati kle nan CSS nou an yon sèl fwa pandan w ap elimine nesesite pou mixin machann tankou sa yo jwenn nan v3.

Nou kenbe lis navigatè yo sipòte atravè Autoprefixer nan yon dosye separe nan depo GitHub nou an. Gade .browserslistrc pou plis detay.

RTLCSS

Bootstrap itilize RTLCSS pou trete CSS konpile epi konvèti yo an RTL - fondamantalman ranplase pwopriyete orizontal ki konnen direksyon (egzanp padding-left) ak opoze yo. Li pèmèt nou sèlman ekri CSS nou an yon sèl fwa epi fè ti ajisteman lè l sèvi avèk kontwòl RTLCSS ak direktiv valè .

Dokiman lokal yo

Kouri dokimantasyon nou an lokalman mande pou itilize Hugo, ki vin enstale atravè pake a hugo-bin npm. Hugo se yon dèlko sit estatik rapidman ak byen ekstansibl ki bay nou: enkli debaz, dosye ki baze sou Markdown, modèl, ak plis ankò. Men ki jan yo kòmanse li:

  1. Kouri nan konfigirasyon zouti ki anwo a pou enstale tout depandans.
  2. /bootstrapSoti nan anyè rasin lan , kouri npm run docs-servenan liy lòd la.
  3. Louvri http://localhost:9001/nan navigatè ou a, epi voilà.

Aprann plis sou itilizasyon Hugo lè w li dokiman li yo .

Depanaj

Si w ta rankontre pwoblèm ak enstale depandans, dezenstale tout vèsyon depandans anvan yo (global ak lokal). Lè sa a, rekòmanse npm install.