Source

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.

Configurarea sculelor

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:

  1. Descărcați și instalați Node.js , pe care îl folosim pentru a ne gestiona dependențele.
  2. Navigați la /bootstrapdirectorul rădăcină și rulați npm installpentru a instala dependențele noastre locale enumerate în package.json .
  3. Instalați Ruby , instalați Bundler cu gem install bundlerși, în final, rulați bundle 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ă.

Folosind scripturi npm

Package.json nostru include următoarele comenzi și sarcini:

Sarcină Descriere
npm run dist npm run distcreează /dist/directorul 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.

Autoprefixer

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 precum cele găsite în v3.

Menținem lista de browsere acceptate prin Autoprefixer într-un fișier separat din depozitul nostru GitHub. Consultați .browserslistrc pentru detalii.

Documentatie locala

Rularea documentației noastre la nivel local necesită utilizarea Jekyll, un generator de site-uri static decent de flexibil, care ne oferă: include de bază, fișiere bazate pe Markdown, șabloane și multe altele. Iată cum să începeți:

  1. Executați configurarea instrumentelor de mai sus pentru a instala Jekyll (generatorul de site) și alte dependențe Ruby cu bundle install.
  2. Din directorul rădăcină /bootstrap, rulați npm run docs-serveîn linia de comandă.
  3. Deschideți http://localhost:9001în browser și voilà.

Aflați mai multe despre utilizarea Jekyll citind documentația acestuia .

Depanare

Dacă întâmpinați probleme cu instalarea dependențelor, dezinstalați toate versiunile anterioare ale dependențelor (global și local). Apoi, reluați npm install.