Source

Ndërtoni mjete

Mësoni se si të përdorni skriptet npm të përfshira të Bootstrap për të ndërtuar dokumentacionin tonë, për të përpiluar kodin burimor, për të ekzekutuar teste dhe më shumë.

Vendosja e veglave

Bootstrap përdor skriptet npm për sistemin e tij të ndërtimit. Paketa.json jonë përfshin metoda të përshtatshme për të punuar me kornizën, duke përfshirë përpilimin e kodit, ekzekutimin e testeve dhe më shumë.

Për të përdorur sistemin tonë të ndërtimit dhe për të ekzekutuar dokumentacionin tonë në nivel lokal, do t'ju duhet një kopje e skedarëve burimor të Bootstrap dhe Node. Ndiqni këto hapa dhe duhet të jeni gati të tundni:

  1. Shkarkoni dhe instaloni Node.js , të cilin e përdorim për të menaxhuar varësitë tona.
  2. Navigoni te /bootstrapdirektoria rrënjësore dhe ekzekutoni npm installpër të instaluar varësitë tona lokale të listuara në package.json .
  3. Instaloni Ruby , instaloni Bundler me gem install bundlerdhe në fund ekzekutoni bundle install. Kjo do të instalojë të gjitha varësitë e Ruby, të tilla si Jekyll dhe shtojcat.
    • Përdoruesit e Windows: Lexoni këtë udhëzues për të vënë në funksion Jekyll pa probleme.

Kur të përfundoni, do të jeni në gjendje të ekzekutoni komandat e ndryshme të ofruara nga linja e komandës.

Përdorimi i skripteve npm

Paketa jonë.json përfshin komandat dhe detyrat e mëposhtme:

Detyrë Përshkrim
npm run dist npm run distkrijon /dist/drejtorinë me skedarë të përpiluar. Përdor Sass , Autoprefixer dhe UglifyJS .
npm test Njësoj si npm run distplus që kryen teste në nivel lokal
npm run docs Ndërton dhe liron CSS dhe JavaScript për dokumente. Më pas mund ta ekzekutoni dokumentacionin në nivel lokal nëpërmjet npm run docs-serve.

Ekzekutoni npm runpër të parë të gjitha skriptet npm.

Autoprefiksues

Bootstrap përdor Autoprefixer (i përfshirë në procesin tonë të ndërtimit) për të shtuar automatikisht prefikset e shitësit në disa veti CSS në kohën e ndërtimit. Duke bërë këtë, na kursen kohë dhe kod duke na lejuar të shkruajmë pjesët kryesore të CSS-së tonë një herë të vetme, duke eliminuar nevojën për përzierje të shitësve si ato që gjenden në v3.

Ne e mbajmë listën e shfletuesve të mbështetur përmes Autoprefixer në një skedar të veçantë brenda depove tona të GitHub. Shihni .browserslistrc për detaje.

Dokumentacioni lokal

Ekzekutimi i dokumentacionit tonë në nivel lokal kërkon përdorimin e Jekyll, një gjenerator faqesh statike mjaft fleksibël që na ofron: përfshirje bazë, skedarë të bazuar në Markdown, shabllone dhe më shumë. Ja se si ta filloni:

  1. Kaloni përmes konfigurimit të veglave të mësipërme për të instaluar Jekyll (ndërtuesin e faqes) dhe varësi të tjera Ruby me bundle install.
  2. Nga direktoria rrënjësore /bootstrap, ekzekutoni npm run docs-servenë vijën e komandës.
  3. Hapeni http://localhost:9001në shfletuesin tuaj dhe voilà.

Mësoni më shumë rreth përdorimit të Jekyll duke lexuar dokumentacionin e tij .

Zgjidhja e problemeve

Nëse hasni probleme me instalimin e varësive, çinstaloni të gjitha versionet e mëparshme të varësisë (globale dhe lokale). Pastaj, riprodhoni npm install.