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

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

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

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

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

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

Если вы хотите создать сайт в существующем репозитории, перейдите к разделу ["Создание сайта](#creating-your-site) ".

1. В правом верхнем углу любой страницы выберите <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="plus icon" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>, а затем нажмите кнопку **"Создать репозиторий**".

   ![Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.](/assets/images/help/repository/repo-create-global-nav-update.png)

2. Используйте раскрывающееся меню "Владелец"\*\*, \*\*чтобы выбрать учетную запись, которую вы хотите владеть репозиторием.
   ![Снимок экрана: меню владельца для нового репозитория GitHub. В меню показаны два параметра, октокат и github.](/assets/images/help/repository/create-repository-owner.png)

3. Введите имя репозитория и необязательное описание. Если вы создаете сайт пользователя или организации, репозиторию необходимо присвоить имя `<user>.github.io` или `<organization>.github.io`. Если имя пользователя или организации содержит прописные буквы, необходимо преобразовать их в нижний регистр.
   Дополнительные сведения см. в разделе [Что такое GitHub Pages?](/ru/pages/getting-started-with-github-pages/what-is-github-pages#types-of-github-pages-sites).
   ![Снимок экрана: параметры GitHub Pages в репозитории. Поле имени репозитория содержит текст "octocat.github.io" и описывается темно-оранжевым цветом.](/assets/images/help/pages/create-repository-name-pages.png)

4. Настройте видимость репозитория. Дополнительные сведения см. в разделе [Сведения о репозиториях](/ru/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility).

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

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

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

Прежде чем создать сайт, необходимо иметь репозиторий для сайта на GitHub. Если вы не создаете сайт в существующем репозитории, см. статью ["Создание репозитория для сайта](#creating-a-repository-for-your-site)".

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

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

2. Укажите, какой источник публикации вы хотите использовать. См [. раздел AUTOTITLE](/ru/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site).

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

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

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

4. Настройте источник публикации. См [. раздел AUTOTITLE](/ru/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site).

5. Ваш сайт GitHub Pages создан и развернут с помощью рабочего процесса GitHub Actions. Дополнительные сведения см. в разделе [Просмотр журнала выполнения рабочего процесса](/ru/actions/monitoring-and-troubleshooting-workflows/viewing-workflow-run-history).

   > \[!NOTE]
   > GitHub Actions предоставляется бесплатно для общедоступных репозиториев. Плата за использование начисляется для частных и внутренних репозиториев, которые превышают число выделяемых ежемесячно бесплатных минут. Дополнительные сведения см. в разделе [Выставление счетов и использование](/ru/actions/learn-github-actions/usage-limits-billing-and-administration).

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

1. Под именем репозитория щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-gear" aria-label="gear" role="img"><path d="M8 0a8.2 8.2 0 0 1 .701.031C9.444.095 9.99.645 10.16 1.29l.288 1.107c.018.066.079.158.212.224.231.114.454.243.668.386.123.082.233.09.299.071l1.103-.303c.644-.176 1.392.021 1.82.63.27.385.506.792.704 1.218.315.675.111 1.422-.364 1.891l-.814.806c-.049.048-.098.147-.088.294.016.257.016.515 0 .772-.01.147.038.246.088.294l.814.806c.475.469.679 1.216.364 1.891a7.977 7.977 0 0 1-.704 1.217c-.428.61-1.176.807-1.82.63l-1.102-.302c-.067-.019-.177-.011-.3.071a5.909 5.909 0 0 1-.668.386c-.133.066-.194.158-.211.224l-.29 1.106c-.168.646-.715 1.196-1.458 1.26a8.006 8.006 0 0 1-1.402 0c-.743-.064-1.289-.614-1.458-1.26l-.289-1.106c-.018-.066-.079-.158-.212-.224a5.738 5.738 0 0 1-.668-.386c-.123-.082-.233-.09-.299-.071l-1.103.303c-.644.176-1.392-.021-1.82-.63a8.12 8.12 0 0 1-.704-1.218c-.315-.675-.111-1.422.363-1.891l.815-.806c.05-.048.098-.147.088-.294a6.214 6.214 0 0 1 0-.772c.01-.147-.038-.246-.088-.294l-.815-.806C.635 6.045.431 5.298.746 4.623a7.92 7.92 0 0 1 .704-1.217c.428-.61 1.176-.807 1.82-.63l1.102.302c.067.019.177.011.3-.071.214-.143.437-.272.668-.386.133-.066.194-.158.211-.224l.29-1.106C6.009.645 6.556.095 7.299.03 7.53.01 7.764 0 8 0Zm-.571 1.525c-.036.003-.108.036-.137.146l-.289 1.105c-.147.561-.549.967-.998 1.189-.173.086-.34.183-.5.29-.417.278-.97.423-1.529.27l-1.103-.303c-.109-.03-.175.016-.195.045-.22.312-.412.644-.573.99-.014.031-.021.11.059.19l.815.806c.411.406.562.957.53 1.456a4.709 4.709 0 0 0 0 .582c.032.499-.119 1.05-.53 1.456l-.815.806c-.081.08-.073.159-.059.19.162.346.353.677.573.989.02.03.085.076.195.046l1.102-.303c.56-.153 1.113-.008 1.53.27.161.107.328.204.501.29.447.222.85.629.997 1.189l.289 1.105c.029.109.101.143.137.146a6.6 6.6 0 0 0 1.142 0c.036-.003.108-.036.137-.146l.289-1.105c.147-.561.549-.967.998-1.189.173-.086.34-.183.5-.29.417-.278.97-.423 1.529-.27l1.103.303c.109.029.175-.016.195-.045.22-.313.411-.644.573-.99.014-.031.021-.11-.059-.19l-.815-.806c-.411-.406-.562-.957-.53-1.456a4.709 4.709 0 0 0 0-.582c-.032-.499.119-1.05.53-1.456l.815-.806c.081-.08.073-.159.059-.19a6.464 6.464 0 0 0-.573-.989c-.02-.03-.085-.076-.195-.046l-1.102.303c-.56.153-1.113.008-1.53-.27a4.44 4.44 0 0 0-.501-.29c-.447-.222-.85-.629-.997-1.189l-.289-1.105c-.029-.11-.101-.143-.137-.146a6.6 6.6 0 0 0-1.142 0ZM11 8a3 3 0 1 1-6 0 3 3 0 0 1 6 0ZM9.5 8a1.5 1.5 0 1 0-3.001.001A1.5 1.5 0 0 0 9.5 8Z"></path></svg> Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="More" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>** и нажмите кнопку **"Параметры**".

   ![Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.](/assets/images/help/repository/repo-actions-settings.png)
2. В разделе "Код и автоматизация" боковой панели щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-browser" aria-label="browser" role="img"><path d="M0 2.75C0 1.784.784 1 1.75 1h12.5c.966 0 1.75.784 1.75 1.75v10.5A1.75 1.75 0 0 1 14.25 15H1.75A1.75 1.75 0 0 1 0 13.25ZM14.5 6h-13v7.25c0 .138.112.25.25.25h12.5a.25.25 0 0 0 .25-.25Zm-6-3.5v2h6V2.75a.25.25 0 0 0-.25-.25ZM5 2.5v2h2v-2Zm-3.25 0a.25.25 0 0 0-.25.25V4.5h2v-2Z"></path></svg> Pages**.
3. Чтобы просмотреть опубликованный сайт, в разделе "GitHub Pages", щелкните **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-link-external" aria-label="link-external" role="img"><path d="M3.75 2h3.5a.75.75 0 0 1 0 1.5h-3.5a.25.25 0 0 0-.25.25v8.5c0 .138.112.25.25.25h8.5a.25.25 0 0 0 .25-.25v-3.5a.75.75 0 0 1 1.5 0v3.5A1.75 1.75 0 0 1 12.25 14h-8.5A1.75 1.75 0 0 1 2 12.25v-8.5C2 2.784 2.784 2 3.75 2Zm6.854-1h4.146a.25.25 0 0 1 .25.25v4.146a.25.25 0 0 1-.427.177L13.03 4.03 9.28 7.78a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042l3.75-3.75-1.543-1.543A.25.25 0 0 1 10.604 1Z"></path></svg> Посетите сайт**.

> \[!NOTE]
> Изменение сайта может занять до 10 минут после отправки изменений в GitHub. Если вы не видите изменения сайта GitHub Pages, отраженные в браузере через час, см [. раздел AUTOTITLE](/ru/pages/setting-up-a-github-pages-site-with-jekyll/about-jekyll-build-errors-for-github-pages-sites).
> \[!NOTE]
>
> * Если вы публикуете из ветви и сайт не публикуется автоматически, убедитесь, что кто-то с разрешениями администратора и проверенный адрес электронной почты отправлен в источник публикации.
> * Фиксации, отправленные рабочим процессом GitHub Actions с использованием `GITHUB_TOKEN` сборки GitHub Pages.

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

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

Если вы используете пользовательский процесс сборки или генератор статических сайтов, отличный от Jekyll, можно написать рабочий процесс GitHub Actions для создания и публикации сайта. GitHub предоставляет шаблоны рабочих процессов для нескольких генераторов статических сайтов. Дополнительные сведения см. в разделе [Настройка источника публикации для вашего сайта GitHub Pages](/ru/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site).

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

> \[!NOTE] GitHub Pages не поддерживает серверные языки, такие как PHP, Ruby или Python.

## Типы MIME в GitHub Pages

Тип MIME — это заголовок, который сервер отправляет в браузер, предоставляя сведения о характере и формате файлов, запрошенных браузером. GitHub Pages поддерживает более 750 типов MIME в тысячах расширений файлов. Список поддерживаемых типов MIME создается из [проекта mime-db](https://github.com/jshttp/mime-db).

Хотя вы не можете указывать специальные типы MIME на уровне файла или репозитория, вы можете добавлять или изменять типы MIME для использования в GitHub Pages. Дополнительные сведения см. [в правилах по предложению улучшений в mime-db](https://github.com/jshttp/mime-db#adding-custom-media-types).

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

Можно добавить дополнительные страницы на сайт, создав новые файлы. Каждый файл будет доступен на сайте в той же структуре каталога, что и источник публикации. Например, если источником публикации для сайта проекта является ветвь `gh-pages`, а вы создаете новый файл с именем `/about/contact-us.md` в ветви `gh-pages`, файл будет доступен по адресу `https://<user>.github.io/<repository>/about/contact-us.html`.

Можно также добавить тему для настройки внешнего вида сайта. Дополнительные сведения см. в разделе [Добавление темы на ваш сайт GitHub Pages с помощью Jekyll](/ru/pages/setting-up-a-github-pages-site-with-jekyll/adding-a-theme-to-your-github-pages-site-using-jekyll).

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

* [О страницах GitHub и Jekyll](/ru/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll).
* [Устранение ошибок сборки Jekyll для сайтов GitHub Pages](/ru/pages/setting-up-a-github-pages-site-with-jekyll/troubleshooting-jekyll-build-errors-for-github-pages-sites)
* [Создание и удаление ветвей в репозитории](/ru/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-and-deleting-branches-within-your-repository)
* [Создание новых файлов](/ru/repositories/working-with-files/managing-files/creating-new-files)
* [Устранение ошибок 404 на сайтах GitHub Pages](/ru/pages/getting-started-with-github-pages/troubleshooting-404-errors-for-github-pages-sites)