Устранение ошибок 404 на сайтах GitHub Pages

Устранение ошибок 404

В этом руководстве вы найдете распространенные причины, по которым может появиться ошибка 404 при создании сайта GitHub Pages.

        [GitHub страница](#githubs-status-page) состояния %}

        [Кэш браузера](#browser-cache)

        [
        `index.html` файл](#indexhtml-file)

        [Содержимое](#directory-contents) каталога

        [Репозиторий](#repository)

Страница состояния GitHub

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

Кэш браузера

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

Файл `index.html`

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

Убедитесь, что у вас есть index.html файл в репозитории для сайта на GitHub. Дополнительные сведения см. в разделе Создание сайта GitHub Pages.
Файл записи должен находиться на верхнем уровне выбранного источника публикации. Например, если источник публикации является каталогом /docs в main ветви, файл записи должен находиться в каталоге /docs в вызываемой mainветви.

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

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

Содержимое каталога

Убедитесь, что содержимое каталога находятся в корневом каталоге.

Репозиторий

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

Ветвь, используемая для публикации сайта, должна быть main или ветвь по умолчанию.
Репозиторий должен иметь фиксацию, отправленную пользователем с разрешениями администратора для репозитория, например владельца репозитория.
Переключение видимости репозитория с общедоступной на частную или наоборот изменит URL-адрес сайта GitHub Pages , что приведет к неработающих ссылках, пока сайт не будет перестроен.
Если вы используете частный репозиторий для сайта GitHub Pages, проверьте, активна ли подписка GitHub Pro, GitHub Teamили GitHub Enterprise Cloud. При продлении плана сайт GitHub Pages будет автоматически развернут повторно. В противном случае вы можете изменить видимость репозитория на общедоступную, чтобы продолжить использование GitHub Pages бесплатно.

Если вы по-прежнему получаете ошибку 404, запустите обсуждение GitHub Community в категории Pages.

Устранение ошибок 404 на сайтах GitHub Pages

Кто может использовать эту функцию?