НАЙКРАЩИЙ САЙТ ДЛЯ ВЕБ-РОЗРОБНИКІВ
GitHub Pages. W3Schools українською. Уроки для початківців

En

GitHub Pages. Створити сайт


В цій статті:

  • Створення репозиторію для вашого сайту
  • Створення свого сайту
  • Наступні кроки
  • Подальше читання

Ви можете створити сайт GitHub Pages у новому чи наявному сховищі (репозиторії).

GitHub Pages доступні у загальнодоступних репозиторіях із GitHub Free та GitHub Free для організацій, а також у загальнодоступних і приватних репозиторіях із GitHub Pro, GitHub Team, GitHub Enterprise Cloud та GitHub Enterprise Server. Для отримання додаткової інформації дивіться "GitHub's products."

Створення репозиторію для вашого сайту

Ви можете створити репозиторій або вибрати існуючий репозиторій для свого сайту.

Якщо ви хочете створити сайт GitHub Pages для репозиторію, де не всі файли в репозиторію пов’язані із сайтом, ви зможете налаштувати джерело публікації для свого сайту. Наприклад, ви можете мати спеціальну гілку та папку для зберігання вихідних файлів вашого сайту, або ви можете використовувати настроюваний робочий процес GitHub Actions для створення та розгортання вихідних файлів сайту.

Якщо обліковий запис, якому належить репозиторій, використовує GitHub Free або GitHub Free для організацій, репозиторій має бути загальнодоступним.

Якщо ви хочете створити сайт в існуючому репозиторію, перейдіть до розділу "Creating your site" ("Створення вашого сайту").

  1. У верхньому правому куті будь-якої сторінки скористайтеся спадним меню та виберіть "New repository" ("Новий репозиторій").
  2. Створити репозиторій на GitHub
  3. Скористайтеся спадним меню "Owner" і виберіть обліковий запис, який має бути власником сховища.
  4. Створити власний репозиторій на GitHub
  5. Введіть назву свого репозиторію та додатковий опис. Якщо ви створюєте сайт користувача або організації, ваш репозиторій повинен мати назву <user>.github.io або <organization>.github.io. Якщо ім’я вашого користувача або організації містить великі літери, ви повинні писати малі літери. Додаткову інформацію див. у розділі "Про GitHub Pages".
  6. Назвати створений репозиторій
  7. Виберіть видимість репозиторію (public, internal, private). Додаткову інформацію див. у розділі "Про репозиторії" на сайті GitHub.
  8. Створити публічний репозиторій на GitHub Pages
  9. Виберіть "Initialize this repository with a README" ("Ініціалізувати це сховище за допомогою файлу README").
  10. Ініціалізувати за допомогою файлу readme
  11. Натисніть кнопку "Створити репозиторій".
  12. Натиснути кнопку Створити репозиторій

Створення свого сайту

Перш ніж ви зможете створити свій сайт, ви повинні мати репозиторій для свого сайту на GitHub. Якщо ви не створюєте свій сайт в існуючому репозиторії, див. "Створення репозиторію для вашого сайту".

Попередження: сайти GitHub Pages є загальнодоступними в Інтернеті, навіть якщо репозиторій для сайту є приватним. Якщо у вашому сховищі сайту є конфіденційні дані, ви можете видалити їх перед публікацією. Додаткову інформацію див. у розділі "Про репозиторії".
  1. На GitHub перейдіть до репозиторію свого сайту.
  2. Вирішіть, яке джерело публікації ви хочете використовувати. Щоб отримати додаткові відомості, перегляньте розділ "Налаштування джерела публікації для вашого сайту GitHub Pages".
  3. Створіть файл входу для свого сайту. GitHub Pages шукатиме файл index.html, index.md або README.md як файл входу для вашого сайту.

    Якщо ваше джерело публікації — це гілка та папка, файл входу має бути на верхньому рівні вихідної папки у вихідній гілці. Наприклад, якщо джерелом публікації є папка /docs у головній гілці, ваш файл входу має бути розміщений у папці /docs у гілці під назвою main.

    Якщо джерелом публікації є робочий процес GitHub Actions, артефакт, який ви розгортаєте, має містити файл входу на верхньому рівні артефакту. Замість того, щоб додавати файл входу до свого сховища, ви можете вибрати, щоб ваш робочий процес GitHub Actions генерував ваш файл входу під час виконання робочого процесу.

  4. Налаштуйте джерело публікації. Щоб отримати додаткові відомості, перегляньте розділ "Налаштування джерела публікації для вашого сайту GitHub Pages".
  5. Під назвою свого сховища клацніть Settings (Налаштування).

    Кнопка налаштування репозиторію
  6. У розділі "Code and automation" ("Код і автоматизація") бічної панелі натисніть Pages ("Сторінки").
  7. Щоб переглянути опублікований сайт, у розділі "GitHub Pages" натисніть Visit site ("Відвідати сайт").

    Скріншот кнопки "Відвідати сайт" поруч із URL-адресою опублікованого сайту
    Примітка. Опублікування змін на вашому сайті може тривати до 10 хвилин після того, як ви надішлете зміни на GitHub. Якщо ви не бачите змін на сайті GitHub Pages, відображених у вашому браузері через годину, перегляньте Про помилки збірки Jekyll для сайтів GitHub Pages.
  8. Ваш сайт GitHub Pages створено та розгорнуто за допомогою робочого процесу GitHub Actions. Додаткову інформацію див. у розділі "Перегляд журналу виконання робочого процесу".
    Примітка. GitHub Actions безкоштовний для публічних репозиторіїв. Плата за користування стягується для приватних і внутрішніх репозиторіїв, які виходять за межі місячного розподілу безкоштовних хвилин. Додаткову інформацію див. у розділі "Обмеження використання, виставлення рахунків та адміністрування".
Примітка. Якщо ви публікуєте з філії, а ваш сайт не опубліковано автоматично, переконайтеся, що хтось із правами адміністратора та підтвердженою адресою електронної пошти надіслав дані до джерела публікації.

Наступні кроки

Ви можете додати більше сторінок на свій сайт, створивши нові файли. Кожен файл буде доступний на вашому сайті в тій же структурі каталогу, що й джерело публікації. Наприклад, якщо джерелом публікації для сайту вашого проєкту є гілка gh-pages, і ви створюєте новий файл під назвою /about/contact-us.md у гілці gh-pages, файл буде доступний за адресою https:// <user>.github.io/<repository>/about/contact-us.html.

Ви також можете додати тему, щоб налаштувати зовнішній вигляд свого сайту. Додаткову інформацію див. у розділі "Додавання теми до вашого сайту GitHub Pages за допомогою Jekyll".

Щоб ще більше налаштувати свій сайт, ви можете використовувати Jekyll, генератор статичних сайтів із вбудованою підтримкою сторінок GitHub. Додаткову інформацію див. у розділі "Про GitHub Pages і Jekyll".


Подальше читання