Як опублікувати сторінку Github

Сторінки Github дозволяють розробникам безкоштовно розміщувати статичний сайт свого проекту. Це одна з ключових об'єктів Github, яка зробила підтримку вільних проектів з відкритим кодом більш економічними, особливо для розробників інді.

Bootstrap і Normalize.css - це кілька популярних сторінок Github. Щоб створити його, потрібно лише створити нову гілку вашого репозиторію проекту і викликати його gh-сторінок. Опублікуйте філію Github.

Після його запуску сайт доступний через URL-адресу, встановлену відносно вашого імені користувача Github, а також назву сховища. ім'я користувача .github.io / ім'я сховища.

Ви можете налаштувати власний домен для вашої сторінки Github. Ми показали, як це зробити в попередньому посібнику.

Спрощені сторінки Github

Створення сторінки Github легко та швидко. Але, є невелика застереження.

Візьміть, наприклад, один з репозитаріїв в нашому акаунті Github, Advent Calendar. Ми маємо дві гілки - майстер і gh-сторінок які поділяють точно такі ж гілки коду.

Ми повинні переконатися, що коди в gh-сторінок завжди синхронізуються з майстер відділення.

На щастя, Github нещодавно спростив її, видаливши gh-сторінок вимоги до галузі. Ми можемо замість цього надіслати сайт безпосередньо через майстер відділення.

Щоб зробити це, перейдіть до будь-якого з вікон налаштувань сховища Github. Прокрутіть вниз до розділу Github Pages і виберіть майстер-гілка меню з вибору.

Ви все налаштовані та можете безпечно видалити gh-сторінок з репозиторію.

Обслуговування документації

Деякі проекти, такі як Bootstrap, Foundation або Skeleton, вимагають сторінки документації. І їх розробники зазвичай також обслуговують ці сторінки документації за допомогою gh-сторінок документ.

Таким чином, репозиторій тепер має дві гілки з абсолютно іншим набором кодів і призначення; один - це головне джерело, інший приймаючої документації а також деякі фрагменти коду. У цій ситуації часто можна знайти конфлікти змін при перемиканні між цими двома гілками.

З цією новою зміною від Github розробники тепер можуть обслуговувати сторінки документації через ім'я папки / docs / в межах майстер відділення. Потім перейдіть до сторінок Github і виберіть наступну опцію, папка master branch / docs.

Тепер підтримка вихідного коду та документації стає більш стриманою.