Примечание. Владельцы организации могут ограничить публикацию сайтов GitHub Pages из репозиториев, принадлежащих организации. Дополнительные сведения см. в разделе Управление публикацией сайтов GitHub Pages для организации.
Создание репозитория для сайта
Для сайта можно создать новый репозиторий или выбрать существующий.
Если необходимо создать сайт GitHub Pages для репозитория, в котором не все файлы имеют отношение к сайту, можно настроить источник публикации. Например, вы можете иметь выделенную ветвь и папку для хранения исходных файлов , или использовать пользовательский рабочий процесс GitHub Actions для создания и развертывания исходных файлов сайта. Чтобы использовать GitHub Actions в качестве источника публикации для GitHub Pages, администратор сайта должен включить GitHub Actions для экземпляр GitHub Enterprise Server. Дополнительные сведения см. в разделе Включение GitHub Actions для сервера GitHub Enterprise.
Чтобы создать сайт в существующем репозитории, перейдите к разделу Создание сайта.
- В правом верхнем углу любой страницы откройте раскрывающееся меню и выберите Новый репозиторий.
<user>.github.ioили<organization>.github.io. Если имя пользователя или организации содержит прописные буквы, необходимо преобразовать их в нижний регистр. Дополнительные сведения см. в разделе Описание GitHub Pages.
Создание сайта
Перед созданием сайта необходимо иметь репозиторий для сайта на GitHub Enterprise Server. Если вы создаете сайт не в существующем репозитории, см. инструкции в статье Создание репозитория для сайта.
Предупреждение. Если администратор сайта включил "Общедоступные страницы", сайты GitHub Pages по умолчанию находятся в открытом доступе, даже если репозиторий для сайта является частным или внутренним. Если в репозитории вашего сайта есть конфиденциальные данные, удалите их перед публикацией. Дополнительные сведения см. в разделах Настройка GitHub Pages для предприятия и Сведения о репозиториях.
-
В GitHub Enterprise Serverперейдите в репозиторий сайта. 1. Укажите, какой источник публикации вы хотите использовать. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
-
Создайте файл записи для сайта. В качестве файла записи для вашего сайта GitHub Pages будет искать файл в формате
index.html,index.mdилиREADME.md.Если ваш источник публикации — это ветвь и папка, файл записи должен находиться на верхнем уровне исходной папки в исходной ветви. Например, если вашим источником публикации является папка
/docsв ветвиmain, файл записи должен располагаться в папке/docsв ветви под названиемmain.Если источник публикации — это рабочий процесс GitHub Actions, развертываемый артефакт должен содержать файл записи на верхнем уровне. Вместо добавления файла записи в репозиторий можно создать его с помощью рабочего процесса GitHub Actions во время запуска. 1. Настройте источник публикации. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages. 1. Под именем репозитория щелкните Параметры. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и выберите пункт Параметры.
-
В разделе «Код и автоматизация» на боковой панели щелкните Страницы .
-
Чтобы просмотреть опубликованный сайт, в разделе "GitHub Pages" щелкните Посетить сайт.
Примечание. Публикация изменений на сайте после передачи изменений в 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.