Проверьте допустимость портфолио до настройки SEO
GitHub Pages предназначен для статических страниц. По официальным ограничениям его нельзя использовать как бесплатный хостинг для ведения онлайн-бизнеса, интернет-магазина или сайта, прежде всего обслуживающего коммерческие транзакции либо коммерческий SaaS. Не считайте портфолио автоматическим исключением: проверьте назначение своего сайта и действующие условия, при сомнениях уточните сценарий у GitHub.
Дальше рассматриваем информационное портфолио с описанием автора, учебных работ и документацией. Это не инструкция по размещению коммерческой витрины в обход правил. Не принимайте через него платежи, пароли и другие чувствительные данные. Если нужен торговый или сервисный продукт, сначала выберите допустимое для него размещение; SEO не отменяет ограничения хостинга.
Источники: GitHub: ограничения использования Pages
Различите корневой сайт и сайт проекта
У сайта пользователя адрес по умолчанию имеет вид owner.github.io, а репозиторий называется owner.github.io. У сайта отдельного проекта адрес обычно содержит имя репозитория: owner.github.io/reponame/. Эта папка становится частью публичного пути. Настройки для корня нельзя без проверки переносить в проект.
Учебная таблица относится к вымышленному аккаунту owner и репозиторию reponame, а не к нашим размещениям. Собственный домен здесь показан как отдельный вариант уже настроенного корневого размещения. Запишите фактический адрес из своего опубликованного сайта, включая HTTPS и путь, прежде чем менять ссылки или сборку.
| Вариант | Учебный публичный URL | Vite base | Пример адреса работы |
|---|---|---|---|
| Сайт пользователя | https://owner.github.io/ | / | https://owner.github.io/work/ |
| Сайт проекта | https://owner.github.io/reponame/ | /reponame/ | https://owner.github.io/reponame/work/ |
| Настроенный собственный домен | https://portfolio.example/ | / | https://portfolio.example/work/ |
Источники: GitHub: типы сайтов Pages и их адреса
Проверьте base, ресурсы и написанные вручную ссылки
Для Vite официальная инструкция задаёт base: "/reponame/" при размещении в папке проекта. Для корневого owner.github.io и собственного домена используется "/". Эти значения относятся к описанным адресам; не подставляйте буквально reponame вместо настоящего имени. После изменения нужна новая сборка и проверка опубликованного результата, а не только локального просмотра.
Отдельно проверьте ссылки, написанные вручную. Путь /work/ начинается от корня домена и у проектного сайта может потерять /reponame/. Параметр сборки не гарантирует исправления всех строк вашего кода и настроек маршрутизатора. Откройте изображение, файл стилей, документ и карточку работы по конечным URL; сохраните ответы для найденных ошибок.
Источники: Vite: статическое размещение на GitHub Pages
Дайте каждой работе самостоятельное текстовое описание
На странице учебного проекта напишите его назначение, свою роль, сделанные части и ограничения. Галерея скриншотов без подписей не объясняет, создали вы интерфейс, документацию или весь прототип. Не выдавайте учебный магазин за действующего заказчика и не приписывайте ему коммерческие результаты. Пользователь должен понимать объект, прежде чем переходить к демонстрации.
Проверьте title, H1, доступный основной текст и обычную ссылку с главной портфолио. Репозиторий с README и опубликованный Pages-сайт — разные адреса и документы. Руководство о представлении SDK в GitHub не заменяет проверку хостинга. Если текст появляется только после JavaScript, отдельно сопоставьте исходный HTML и результат обработки страницы.
Продолжить: Как представить репозиторий и README продукта: отдельная задача; Как проверить содержание JavaScript-страницы в HTML и после рендеринга
Сверьте canonical с конечным публичным адресом
Для учебной работы сайта проекта ожидаемый адрес — https://owner.github.io/reponame/work/. Проверьте, что canonical не указывает на localhost, главную портфолио или тот же путь без имени репозитория. У каждой самостоятельной страницы должен быть согласованный основной адрес; не назначайте всем работам одну главную только ради устранения предупреждений.
При подключении собственного домена сначала подтвердите его фактическую настройку и доступность HTTPS по официальному порядку GitHub. Затем проверьте ссылки и canonical на конечном размещении. Не удаляйте папку проекта из адресов заранее. Сохраните наблюдение о переходе со старого адреса: предположение о перенаправлении не заменяет проверки реального ответа.
Проверьте настоящую ошибку 404 без подмены главной
Откройте существующую вложенную страницу напрямую и обновите её. Затем введите выдуманный путь внутри сайта проекта, например /reponame/missing-check/. Для отсутствующего адреса проверьте HTTP 404 и понятное сообщение со ссылкой к портфолио. Ссылка возврата тоже должна учитывать папку репозитория, иначе даже страница ошибки отправит посетителя не туда.
GitHub документирует собственную страницу ошибки через 404.html или 404.md. Она помогает человеку, но не заменяет корректные адреса. Не используйте копию приложения в 404.html как доказательство исправленного SEO: отрисованный интерфейс не подтверждает успешный HTTP-ответ существующей работы. Если выбранная маршрутизация требует такого обхода, оцените статические страницы или другое подходящее размещение.
Источники: GitHub: собственная страница 404
Соберите лист проверки опубликованного портфолио
Запишите главную, одну работу, ресурс, документ и неизвестный путь: ожидаемый URL, фактический статус, текст и canonical там, где он предусмотрен. Приложите дату и сохранённый ответ. Проверку разрешений обхода и индексирования проводите уже для этих адресов, не предполагая, что публичный репозиторий автоматически делает все страницы доступными поиску.
Google связывает участие ссылок в AI-функциях поиска с индексированием и возможностью сниппета, а не с брендом хостинга. Чтение портфолио по переданной ссылке проверяйте отдельно от обнаружения в поиске. Если запутались в путях и статусах, диагностика поможет разобрать согласованные URL и подготовить проверяемое задание исполнителю без обещания будущей цитаты.
Продолжить: SEO сайта после вайбкодинга: что проверить до запуска в поиск и ИИ-ответы; Как оформить портфолио, чтобы Алиса и ChatGPT понимали, что вы умеете; Демо-сайт попал в поиск вместо портфолио: как отделить учебный проект; Посмотреть состав диагностики