in English

Будівельні інструменти

Дізнайтеся, як використовувати включені сценарії npm Bootstrap для створення нашої документації, компіляції вихідного коду, запуску тестів тощо.

Налаштування інструменту

Bootstrap використовує скрипти npm для своєї системи збирання. Наш package.json містить зручні методи роботи з фреймворком, включаючи компіляцію коду, виконання тестів тощо.

Щоб використовувати нашу систему збирання та запускати нашу документацію локально, вам знадобиться копія вихідних файлів Bootstrap і Node. Виконайте ці кроки, і ви будете готові до розгойдування:

  1. Завантажте та встановіть Node.js , який ми використовуємо для керування нашими залежностями.
  2. Або завантажте вихідні коди Bootstrap, або розгалужте репозиторій Bootstrap .
  3. Перейдіть до кореневого /bootstrapкаталогу та запустіть npm installустановку наших локальних залежностей, перелічених у package.json .
  4. Встановіть Ruby , установіть Bundler за допомогою gem install bundlerі, нарешті, запустіть bundle install. Це встановить усі залежності Ruby, такі як Jekyll і плагіни.
    • Користувачі Windows: прочитайте цей посібник , щоб налаштувати Jekyll без проблем.

Після завершення ви зможете запускати різні команди з командного рядка.

Використання скриптів npm

Наш package.json містить такі команди та завдання:

завдання опис
npm run dist npm run distстворює /dist/каталог зі скомпільованими файлами. Використовує Sass , Autoprefixer і terser .
npm test Так само, як npm run distплюс, він запускає тести локально
npm run docs Створює та лінзує CSS і JavaScript для документів. Потім ви можете запустити документацію локально через npm run docs-serve.

Запустіть npm run, щоб переглянути всі сценарії npm.

Автопрефікс

Bootstrap використовує Autoprefixer (включений у наш процес збірки), щоб автоматично додавати префікси постачальника до деяких властивостей CSS під час створення. Це економить наш час і код, дозволяючи нам написати ключові частини нашого CSS один раз, усуваючи потребу в міксинах постачальників, подібних до тих, що є у v3.

Ми зберігаємо список браузерів, які підтримуються через Autoprefixer, в окремому файлі в нашому репозиторії GitHub. Дивіться .browserslistrc для деталей.

Локальна документація

Запуск нашої документації локально вимагає використання Jekyll, досить гнучкого статичного генератора сайтів, який надає нам: базові включення, файли на основі Markdown, шаблони тощо. Ось як це почати:

  1. Виконайте налаштування інструментів вище, щоб установити Jekyll (конструктор сайтів) та інші залежності Ruby за допомогою bundle install.
  2. З кореневого /bootstrapкаталогу запустіть npm run docs-serveу командному рядку.
  3. Відкрийте http://localhost:9001у своєму браузері, і вуаля.

Дізнайтеся більше про використання Jekyll, прочитавши його документацію .

Вирішення проблем

Якщо у вас виникнуть проблеми зі встановленням залежностей, видаліть усі попередні версії залежностей (глобальні та локальні). Потім запустіть повторно npm install.