Narzędzia do budowania
Dowiedz się, jak używać skryptów npm dołączonych do usługi Bootstrap, aby tworzyć naszą dokumentację, kompilować kod źródłowy, uruchamiać testy i nie tylko.
Bootstrap używa skryptów NPM do swojego systemu kompilacji. Nasz package.json zawiera wygodne metody pracy z frameworkiem, w tym kompilowanie kodu, uruchamianie testów i wiele innych.
Aby korzystać z naszego systemu kompilacji i uruchamiać naszą dokumentację lokalnie, będziesz potrzebować kopii plików źródłowych Bootstrap i węzła. Wykonaj następujące kroki i powinieneś być gotowy do rocka:
- Pobierz i zainstaluj Node.js , którego używamy do zarządzania naszymi zależnościami.
- Przejdź do
/bootstrapkatalogu głównego i uruchom,npm installaby zainstalować nasze lokalne zależności wymienione w package.json . - Zainstaluj Rubiego , zainstaluj Bundlera i
gem install bundleruruchombundle install. Spowoduje to zainstalowanie wszystkich zależności Rubiego, takich jak Jekyll i wtyczki.- Użytkownicy systemu Windows: Przeczytaj ten przewodnik , aby uruchomić Jekyll bez problemów.
Po zakończeniu będziesz mógł uruchamiać różne polecenia dostarczone z wiersza poleceń.
Nasz plik package.json zawiera następujące polecenia i zadania:
| Zadanie | Opis |
|---|---|
npm run dist |
npm run disttworzy /distkatalog ze skompilowanymi plikami. Używa Sass , Autoprefixer i UglifyJS . |
npm test |
Tak samo jak npm run distplus uruchamia testy lokalnie |
npm run docs |
Buduje i łączy CSS i JavaScript dla dokumentów. Następnie możesz uruchomić dokumentację lokalnie poprzez npm run docs-serve. |
Uruchom npm run, aby zobaczyć wszystkie skrypty npm.
Bootstrap używa Autoprefixera (zawartego w naszym procesie budowania) do automatycznego dodawania prefiksów dostawców do niektórych właściwości CSS w czasie budowania. Dzięki temu oszczędzamy czas i kod, pozwalając nam napisać kluczowe części naszego CSS za jednym razem, jednocześnie eliminując potrzebę dodawania dodatków dostawców, takich jak te, które można znaleźć w v3.
Utrzymujemy listę przeglądarek obsługiwanych przez Autoprefixer w osobnym pliku w naszym repozytorium GitHub. Zobacz /package.json, aby uzyskać szczegółowe informacje.
Uruchamianie naszej dokumentacji lokalnie wymaga użycia Jekyll, przyzwoicie elastycznego generatora witryn statycznych, który zapewnia nam: podstawowe dołączenia, pliki oparte na Markdown, szablony i wiele innych. Oto jak zacząć:
- Uruchom powyższą konfigurację narzędzi, aby zainstalować Jekyll (konstruktor witryn) i inne zależności Rubiego za pomocą
bundle install. - Z
/bootstrapkatalogu głównego uruchomnpm run docs-servew wierszu poleceń. - Otwórz
http://localhost:9001w przeglądarce i gotowe.
Dowiedz się więcej o korzystaniu z Jekyll, czytając jego dokumentację .
W przypadku problemów z instalacją zależności odinstaluj wszystkie poprzednie wersje zależności (globalne i lokalne). Następnie uruchom ponownie npm install.