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
/bootstrap
katalogu głównego i uruchom,npm install
aby zainstalować nasze lokalne zależności wymienione w package.json . - Zainstaluj Rubiego , zainstaluj Bundlera i
gem install bundler
uruchombundle 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 dist tworzy /dist katalog ze skompilowanymi plikami. Używa Sass , Autoprefixer i UglifyJS . |
npm test |
Tak samo jak npm run dist plus 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
/bootstrap
katalogu głównego uruchomnpm run docs-serve
w wierszu poleceń. - Otwórz
http://localhost:9001
w 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
.