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

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

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

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

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

1. В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".

   

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

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

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

5. Включите параметр «Добавить файл сведений».****

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

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

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

Если администратор сайта включил общедоступные страницы, сайты доступны в Интернете, GitHub Pages даже если репозиторий сайта является частным или внутренним. Если в репозитории вашего сайта есть конфиденциальные данные, удалите их перед публикацией. Дополнительные сведения см. в разделе [AUTOTITLE и Настройка страниц GitHub для вашего предприятия](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility).

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

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

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

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

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

4. Настройте источник публикации. См . раздел AUTOTITLE.

Просмотр опубликованного сайта

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

   

2. боковой панели щелкните Pages.

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

Генераторы статических сайтов

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

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

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

Типы MIME в GitHub Pages

Тип MIME — это заголовок, который сервер отправляет в браузер, предоставляя сведения о характере и формате файлов, запрошенных браузером. GitHub Pages поддерживает более 750 типов MIME в тысячах расширений файлов. Список поддерживаемых типов MIME создается из проекта mime-db.

Хотя настраиваемые типы MIME нельзя указывать на основе каждого файла или для каждого репозитория, можно добавлять или изменять типы MIME для использования GitHub Pages. Дополнительные сведения см. в правилах по предложению улучшений в mime-db.

Следующие шаги

Можно добавить дополнительные страницы на сайт, создав новые файлы. Каждый файл будет доступен на сайте в той же структуре каталога, что и источник публикации. Например, если источник публикации для сайта проекта является gh-pages ветвью, и вы создаете новый файл, вызываемого /about/contact-us.md в gh-pages ветви, файл будет доступен по `адресу http(s):///pages/about///contact-us.html'.

Можно также добавить тему для настройки внешнего вида сайта. Дополнительные сведения см. в разделе Добавление темы на ваш сайт GitHub Pages с помощью Jekyll.

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

• О страницах GitHub и Jekyll.
• Устранение ошибок сборки Jekyll для сайтов GitHub Pages
• Управление ветвями в репозитории
• Создание новых файлов
• Устранение ошибок 404 на сайтах GitHub Pages