Как опубликовать страницу Github

Github Pages позволяют разработчикам бесплатно размещать статический веб-сайт своего проекта. Это одна из ключевых возможностей Github, благодаря которой поддержка бесплатных проектов с открытым исходным кодом стала более экономичной, особенно для независимых разработчиков..

Bootstrap и Normalize.css - пара популярных страниц Github. Чтобы создать его, вам нужно всего лишь создать новую ветку репозитория вашего проекта и вызвать его GH-страницы. Опубликуйте ветку на Github.

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

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

Github Pages Упрощенный

Создать страницу Github легко и быстро. Но есть небольшая оговорка.

Возьмите один из демонстрационных репозиториев в нашей учетной записи Github, например, Advent Calendar. У нас есть две ветви - мастер а также GH-страницы которые разделяют одинаковые ветви кода.

Нам нужно убедиться, что коды в GH-страницы всегда синхронизируются с мастер ветка.

К счастью, Github недавно сделал это проще, удалив GH-страницы отраслевое требование. Теперь мы можем кормить сайт напрямую через мастер ветка.

Для этого перейдите на любой экран настроек вашего репозитория Github. Прокрутите вниз до раздела Github Pages и выберите мастер ветка меню из выбора.

Вы все готовы и можете безопасно удалить GH-страницы ветка из хранилища.

Сервисная документация

Некоторые проекты, такие как Bootstrap, Foundation или Skeleton, требуют страницы документации. И их разработчики обычно также обслуживают эти страницы документации через GH-страницы документ.

Таким образом, хранилище теперь имеет две ветви с совершенно другим набором кодов и назначением; один это основной источник, в то время как другой основная документация а также некоторые фрагменты кода. В этой ситуации вы можете часто находить конфликты изменений при переключении между этими двумя ветвями.

С этим новым изменением от Github разработчики теперь могут обслуживать страницы документации через имя папки / документы / в пределах мастер ветка. Затем перейдите на страницы Github и выберите следующую опцию, главная ветка / папка docs.

Теперь поддержка исходного кода и документации стала более строгой.