Skip to main content

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

Вы можете создать сайт GitHub Pages в новом или существующем репозитории.

GitHub Pages доступен в общедоступных репозиториях при использовании GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях при использовании GitHub Pro, GitHub Team, GitHub Enterprise Cloud и GitHub Enterprise Server. Дополнительные сведения см. в разделе Продукты GitHub.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. В разделе «Код и автоматизация» на боковой панели щелкните Страницы .

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

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

  5. Ваш сайт 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.

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