Construiește instrumente
Aflați cum să utilizați scripturile npm incluse în Bootstrap pentru a construi documentația noastră, a compila codul sursă, a rula teste și multe altele.
Bootstrap folosește scripturi NPM pentru sistemul său de construcție. Package.json include metode convenabile de lucru cu cadrul, inclusiv compilarea codului, rularea testelor și multe altele.
Pentru a utiliza sistemul nostru de compilare și a rula documentația noastră la nivel local, veți avea nevoie de o copie a fișierelor sursă Bootstrap și a Node. Urmați acești pași și ar trebui să fiți gata să vă rockați:
- Descărcați și instalați Node.js , pe care îl folosim pentru a ne gestiona dependențele.
- Navigați la
/bootstrapdirectorul rădăcină și rulaținpm installpentru a instala dependențele noastre locale enumerate în package.json . - Instalați Ruby , instalați Bundler cu
gem install bundlerși, în final, rulațibundle install. Acest lucru va instala toate dependențele Ruby, cum ar fi Jekyll și pluginurile.- Utilizatori Windows: Citiți acest ghid pentru a pune Jekyll să funcționeze fără probleme.
Când ați terminat, veți putea rula diferitele comenzi furnizate din linia de comandă.
Package.json nostru include următoarele comenzi și sarcini:
| Sarcină | Descriere |
|---|---|
npm run dist |
npm run distcreează /distdirectorul cu fișiere compilate. Utilizează Sass , Autoprefixer și UglifyJS . |
npm test |
La fel ca și npm run distplus, rulează teste local |
npm run docs |
Compilează și lasă CSS și JavaScript pentru documente. Apoi puteți rula documentația local prin npm run docs-serve. |
Rulați npm runpentru a vedea toate scripturile npm.
Bootstrap folosește Autoprefixer (inclus în procesul nostru de construire) pentru a adăuga automat prefixe de furnizor la unele proprietăți CSS în timpul construirii. Procedând astfel, ne economisim timp și cod, permițându-ne să scriem părți cheie ale CSS-ului nostru o singură dată, eliminând în același timp nevoia de mix-uri de furnizori, cum ar fi cele găsite în v3.
Menținem lista de browsere acceptate prin Autoprefixer într-un fișier separat din depozitul nostru GitHub. Consultați /package.json pentru detalii.
Rularea documentației noastre la nivel local necesită utilizarea Jekyll, un generator de site static decent flexibil care ne oferă: include de bază, fișiere bazate pe Markdown, șabloane și multe altele. Iată cum să începeți:
- Executați configurarea instrumentelor de mai sus pentru a instala Jekyll (generatorul de site) și alte dependențe Ruby cu
bundle install. - Din directorul rădăcină
/bootstrap, rulaținpm run docs-serveîn linia de comandă. - Deschideți
http://localhost:9001în browser și voilà.
Aflați mai multe despre utilizarea Jekyll citind documentația acestuia .
Dacă întâmpinați probleme la instalarea dependențelor, dezinstalați toate versiunile anterioare de dependențe (global și local). Apoi, reluați npm install.