Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

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

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

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

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

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

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

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

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

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

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

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

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

  1. В GitHub Enterprise Serverперейдите в репозиторий сайта. 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" щелкните Посетить сайт. Снимок экрана: сообщение с подтверждением для GitHub Pages с URL-адресом сайта. Справа от URL-адреса кнопка с меткой "Посетить сайт" выделена темно-оранжевым цветом.

    Примечание. Публикация изменений на сайте после передачи изменений в GitHub Enterprise Server может занять до 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.

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