Source

Tools bauen

Léiert wéi Dir Bootstrap's abegraff npm Scripte benotzt fir eis Dokumentatioun ze bauen, Quellcode ze kompiléieren, Tester auszeféieren, a méi.

Tooling Setup

Bootstrap benotzt npm Scripte fir säi Build System. Eis package.json enthält praktesch Methoden fir mam Kader ze schaffen, inklusiv Kompiléierungscode, Lafen Tester, a méi.

Fir eise Build System ze benotzen an eis Dokumentatioun lokal auszeféieren, braucht Dir eng Kopie vun de Bootstrap Quelldateien an Node. Follegt dës Schrëtt an Dir sollt prett sinn ze rocken:

  1. Eroflueden an installéieren Node.js , déi mir benotze fir eis Ofhängegkeeten ze managen.
  2. Navigéiert an de Root /bootstrap-Verzeichnis a lafen npm installfir eis lokal Ofhängegkeeten ze installéieren, déi an package.json opgezielt sinn .
  3. Installéiert Ruby , installéiert Bundler mat gem install bundler, a lafen endlech bundle install. Dëst wäert all Ruby Ofhängegkeeten installéieren, wéi Jekyll a Plugins.
    • Windows Benotzer: Liest dëse Guide fir de Jekyll ouni Probleemer opzemaachen a lafen.

Wann Dir fäerdeg sidd, kënnt Dir déi verschidde Kommandoen aus der Kommandozeil ausféieren.

Benotzt npm Scripten

Eis package.json enthält déi folgend Kommandoen an Aufgaben:

Aufgab Beschreiwung
npm run dist npm run disterstellt den /dist/Dossier mat kompiléierten Dateien. Benotzt Sass , Autoprefixer , an UglifyJS .
npm test Selwecht wéi npm run distplus et leeft Tester lokal
npm run docs Baut a lints CSS a JavaScript fir Dokumenter. Dir kënnt dann d'Dokumentatioun lokal iwwer npm run docs-serve.

Run npm runfir all npm Scripten ze gesinn.

Autoprefixer

Bootstrap benotzt Autoprefixer (abegraff an eisem Build-Prozess) fir automatesch Verkeefer Präfixe fir e puer CSS-Eegeschafte bei der Bauzäit ze addéieren. Dat ze maachen spuert eis Zäit a Code andeems mir eis Schlësseldeeler vun eisem CSS eng eenzeg Kéier schreiwen, wärend d'Bedierfnes fir Verkeefermixins eliminéiert wéi déi am v3 fonnt ginn.

Mir halen d'Lëscht vun de Browser ënnerstëtzt duerch Autoprefixer an enger separater Datei an eisem GitHub Repository. Gesinn .browserslistrc fir Detailer.

Lokal Dokumentatioun

Eis Dokumentatioun lokal ze lafen erfuerdert d'Benotzung vum Jekyll, en anstänneg flexibel statesche Site Generator deen eis ubitt: Basis enthält, Markdown-baséiert Dateien, Templates, a méi. Hei ass wéi et unzefänken:

  1. Run duerch den Tooling-Setup hei uewen fir Jekyll (de Site Builder) an aner Ruby Ofhängegkeeten mat bundle install.
  2. Aus dem Root /bootstrapVerzeechnes, lafen npm run docs-servean der Kommandozeil.
  3. Open http://localhost:9001an Ärem Browser, a voilà.

Léiert méi iwwer d'Benotzung vu Jekyll andeems Dir seng Dokumentatioun liest .

Troubleshooting

Sollt Dir Problemer mat der Installatioun vun Ofhängegkeeten begéinen, deinstalléiert all fréier Ofhängegkeetsversioune (global a lokal). Dann, widderhuelen npm install.