Будівельні інструменти
Дізнайтеся, як використовувати включені сценарії npm Bootstrap для створення нашої документації, компіляції вихідного коду, запуску тестів тощо.
Налаштування інструменту
Bootstrap використовує скрипти npm для своєї системи збирання. Наш package.json містить зручні методи роботи з фреймворком, включаючи компіляцію коду, виконання тестів тощо.
Щоб використовувати нашу систему збирання та запускати нашу документацію локально, вам знадобиться копія вихідних файлів Bootstrap і Node. Виконайте ці кроки, і ви будете готові до розгойдування:
- Завантажте та встановіть Node.js , який ми використовуємо для керування нашими залежностями.
- Перейдіть до кореневого
/bootstrap
каталогу та запустітьnpm install
установку наших локальних залежностей, перелічених у package.json . - Встановіть Ruby , установіть Bundler за допомогою
gem install bundler
і, нарешті, запустітьbundle install
. Це встановить усі залежності Ruby, такі як Jekyll і плагіни.- Користувачі Windows: прочитайте цей посібник , щоб налаштувати Jekyll без проблем.
Після завершення ви зможете запускати різні команди з командного рядка.
Використання скриптів npm
Наш package.json містить такі команди та завдання:
завдання | опис |
---|---|
npm run dist |
npm run dist створює /dist/ каталог зі скомпільованими файлами. Використовує Sass , Autoprefixer і UglifyJS . |
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, шаблони тощо. Ось як це почати:
- Виконайте налаштування інструментів вище, щоб установити Jekyll (конструктор сайтів) та інші залежності Ruby за допомогою
bundle install
. - З кореневого
/bootstrap
каталогу запустітьnpm run docs-serve
у командному рядку. - Відкрийте
http://localhost:9001
у своєму браузері, і вуаля.
Дізнайтеся більше про використання Jekyll, прочитавши його документацію .
Вирішення проблем
Якщо у вас виникнуть проблеми зі встановленням залежностей, видаліть усі попередні версії залежностей (глобальні та локальні). Потім запустіть повторно npm install
.