Создание сайта GitHub Pages

Создание репозитория для сайта

Для сайта можно создать новый репозиторий или выбрать существующий.

Если необходимо создать сайт GitHub Pages для репозитория, в котором не все файлы имеют отношение к сайту, можно настроить источник публикации. Например, вы можете иметь выделенную ветвь и папку для хранения исходных файлов файлы.

Чтобы создать сайт в существующем репозитории, перейдите к разделу Создание сайта.

1. В правом верхнем углу любой страницы откройте раскрывающееся меню и выберите Новый репозиторий.

   1. В раскрывающемся меню Владелец выберите учетную запись, которая должна владеть репозиторием. 1. Введите имя репозитория и необязательное описание. Если вы создаете сайт пользователя или организации, репозиторию необходимо присвоить имя <user>.github.io или <organization>.github.io. Если имя пользователя или организации содержит прописные буквы, необходимо преобразовать их в нижний регистр. Дополнительные сведения см. в разделе Описание GitHub Pages. 1. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях. 1. Выберите Initialize this repository with a README (Инициализировать репозиторий с помощью файла сведений). 1. Щелкните Создать репозиторий.

Создание сайта

Перед созданием сайта необходимо иметь репозиторий для сайта на GitHub AE. Если вы создаете сайт не в существующем репозитории, см. инструкции в статье Создание репозитория для сайта.

1. В GitHub AEперейдите в репозиторий сайта. 1. Укажите, какой источник публикации вы хотите использовать. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.

2. Создайте файл записи для сайта. В качестве файла записи для вашего сайта GitHub Pages будет искать файл в формате index.html, index.md или README.md.

   Файл записи должен находиться на верхнем уровне выбранного источника публикации. Например, если источником публикации является папка /docs в ветви main, файл записи должен располагаться в папке /docs в ветви под названием main. 1. Настройте источник публикации. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages. 1. Под именем репозитория щелкните Параметры. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку Параметры.

   

3. В разделе "Код и автоматизация" боковой панели щелкните Pages.

4. Чтобы просмотреть опубликованный сайт, в разделе "GitHub Pages" щелкните Посетить сайт.

   Примечание. Публикация изменений на сайте после передачи изменений в GitHub AE может занять до 10 минут. Если через час изменения сайта GitHub Pages не отображаются в браузере, см. раздел Сведения об ошибках сборки Jekyll для сайтов GitHub Pages.

Дальнейшие действия

Можно добавить дополнительные страницы на сайт, создав новые файлы. Каждый файл будет доступен на сайте в той же структуре каталога, что и источник публикации. Например, если источником публикации для сайта проекта является ветвь gh-pages, а вы создаете новый файл с именем /about/contact-us.md в ветви gh-pages, файл будет доступен по адресу http(s)://<hostname>/pages/<username>/<repository>/about/contact-us.html.

Можно также добавить тему для настройки внешнего вида сайта. Дополнительные сведения см. в разделе Добавление темы на сайт GitHub Pages с помощью Jekyll.

Чтобы настроить сайт еще лучше, можно использовать Jekyll, генератор статических сайтов со встроенной поддержкой GitHub Pages. Дополнительные сведения см. в разделе Сведения о GitHub Pages и Jekyll.

Дополнительные материалы

• "Устранение ошибок сборки Jekyll для сайтов GitHub Pages"
• "Создание и удаление ветвей в репозитории"
• "Создание новых файлов"