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