Source

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.

Konfiguracja oprzyrządowania

Bootstrap używa skryptów npm dla 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:

  1. Pobierz i zainstaluj Node.js , którego używamy do zarządzania naszymi zależnościami.
  2. Przejdź do /bootstrapkatalogu głównego i uruchom, npm installaby zainstalować nasze lokalne zależności wymienione w package.json .
  3. Zainstaluj Rubiego , zainstaluj Bundlera i gem install bundleruruchom bundle 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ń.

Korzystanie ze skryptów npm

Nasz plik package.json zawiera następujące polecenia i zadania:

Zadanie Opis
npm run dist npm run disttworzy /dist/katalog 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.

Autoprefiks

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 .browserslistrc po szczegóły.

Dokumentacja lokalna

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ąć:

  1. Uruchom powyższą konfigurację narzędzi, aby zainstalować Jekyll (konstruktor witryn) i inne zależności Rubiego za pomocą bundle install.
  2. Z /bootstrapkatalogu głównego uruchom npm run docs-servew wierszu poleceń.
  3. Otwórz http://localhost:9001w przeglądarce i gotowe.

Dowiedz się więcej o korzystaniu z Jekyll, czytając jego dokumentację .

Rozwiązywanie problemów

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.