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

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

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

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

Если учетная запись, которой принадлежит репозиторий, использует GitHub Free или GitHub Free для организаций, репозиторий должен быть общедоступным.

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

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

   

2. В раскрывающемся меню Владелец выберите учетную запись, которая должна владеть репозиторием.

3. Введите имя репозитория и необязательное описание. Если вы создаете сайт пользователя или организации, репозиторию необходимо присвоить имя <user>.github.io или <organization>.github.io. Если имя пользователя или организации содержит прописные буквы, необходимо преобразовать их в нижний регистр. Дополнительные сведения см. в разделе Описание GitHub Pages.

4. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях.

5. Выберите Initialize this repository with a README (Инициализировать репозиторий с помощью файла сведений).

6. Щелкните Создать репозиторий.

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

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

1. В GitHubперейдите в репозиторий сайта.

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

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

   Если ваш источник публикации — это ветвь и папка, файл записи должен находиться на верхнем уровне исходной папки в исходной ветви. Например, если вашим источником публикации является папка /docs в ветви main, файл записи должен располагаться в папке /docs в ветви под названием main.

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

4. Настройте источник публикации. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.

5. Под именем репозитория щелкните Параметры. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку Параметры.

   

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

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

   Примечание. Публикация изменений на сайте после передачи изменений в GitHub может занять до 10 минут. Если через час изменения сайта 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 Pages. Дополнительные сведения см. в разделе Сведения о GitHub Pages и Jekyll.

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

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