Skip to content

Latest commit

 

History

History
92 lines (67 loc) · 6.81 KB

README.uk.md

File metadata and controls

92 lines (67 loc) · 6.81 KB

Parcel template

Цей проект створено за допомогою Parcel. Для ознайомлення та налаштування додаткових можливостей, зверніться до документації.

Підготовка нового проекту

  1. Переконайтеся, що на вашому комп'ютері встановлена LTS-версія Node.js. Завантажте та встановіть якщо потрібно.
  2. Клонуйте цей репозиторій.
  3. Змініть ім'я папки з parcel-project-template на ім'я свого проекту.
  4. Створіть новий порожній репозиторій на GitHub.
  5. Відкрийте проект в VSCode, запустіть термінал і пов'яжіть проект з GitHub-репозиторієм за інструкцією.
  6. Встановіть залежності проекту в терміналі командою npm install .
  7. Запустіть режим розробки, виконавши команду npm start.
  8. Перейдіть у браузері за адресою http://localhost:1234. Ця сторінка автоматично оновлюватиметься після збереження змін у файлах проекту.

Файли та папки

  • Всі стилізовані файли повинні знаходитися у папці src/sass і імпортуватися в файли стилів сторінок. Наприклад, для index.html файл стилів називається index.scss.
  • Зображення додавайте у папку src/images. Збірник їх оптимізує, але лише під час розгортання продакшн-версії проекту. Все це відбувається в хмарі, щоб не навантажувати ваш комп'ютер, оскільки на слабших машинах це може зайняти багато часу.

Розгортання

Для налаштування розгортання проекту потрібно виконати кілька додаткових кроків щодо налаштування вашого репозиторію. Перейдіть на вкладку Settings і у підсекції Actions виберіть General.

GitHub actions settings

Прокрутіть сторінку до останньої секції, переконайтеся, що вибрані параметри так, як показано на наступному зображенні, і натисніть Save. Без цих налаштувань сборці не вистачить прав для автоматизації процесу розгортання.

GitHub actions settings

Продакшн-версія проекту автоматично збирається та розгортається на GitHub Pages у гілку gh-pages кожного разу, коли оновлюється гілка main. Наприклад, після прямого пуша або після прийняття запиту на витягування. Для цього необхідно в файлі package.json змінити поле homepage та скрипт build, замінивши your_username та your_repo_name на свої дані, та відправити зміни на GitHub.

"homepage": "https://your_username.github.io/your_repo_name/",
"scripts": {
  "build": "parcel build src/*.html --public-url /your_repo_name/"
},

Потім вам потрібно зайти в налаштування репозиторія GitHub (Settings > Pages) та вказати розповсюдження файлів продакшн версії з папки /root гілки gh-pages, якщо це не було зроблено автоматично.

GitHub Pages settings

Статус розгортання

Статус останнього коміту розгортання відображається піктограмою біля його ідентифікатора.

  • Жовтий колір - триває збірка та розгортання проекту.
  • Зелений колір - розгортання завершилося успішно.
  • Червоний колір - під час лінтінгу, збірки або розгортання сталася помилка.

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

Deployment status

Жива сторінка

Зазвичай через кілька хвилин живу сторінку можна буде переглянути за адресою, яку ви вказали у властивості homepage. Наприклад, ось посилання на живу версію для цього репозиторію: https://goitacademy.github.io/parcel-project-template.

Якщо відкривається порожня сторінка, переконайтеся, що у вкладці Console немає помилок, пов'язаних з неправильними шляхами до файлів CSS та JS проекту (404). Ймовірно, у вас неправильне значення властивості homepage або скрипта build у файлі package.json.

Як це працює

How it works

  1. Після кожного натискання на main репозиторій GitHub спеціальний скрипт (GitHub Action) запускається з файлу .github/workflows/deploy.yml.
  2. Усі файли репозиторію копіюються на сервері, де проект ініціалізується та проходить збірку перед деплоєм.
  3. Якщо всі етапи успішно пройдені, зібрана продакшн версія файлів проекту надсилається до гілки gh-pages. У випадку невдачі, причина буде вказана в журналі виконання скрипта.