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

Info

В этом разделе описаны базовые шаги для публикации первого сайта с помощью GitVerse Pages.

GitVerse Pages позволяет публиковать:

  • персональные сайты и сайты уровня организации;
  • сайты проектов.

1. Создайте репозиторий

Можно использовать репозиторий с любым названием.
Сайт будет опубликован по адресу:

https://<owner>.gitverse.site/<repo-name>

2. Добавьте файлы сайта

Для первой публикации достаточно одного из файлов:

  • index.html;
  • index.md;
  • README.md.

GitVerse Pages использует следующий приоритет:

index.html → index.md → README.md

Файл должен находиться в корне публикуемой директории.

3. Подготовьте ветку для публикации

GitVerse Pages может публиковать сайт из любой ветки репозитория.

Чаще всего используют:

  • pages — отдельная ветка для сайта;
  • master или main — основная ветка проекта.

По умолчанию публикация выполняется из корня репозитория (/).

Также можно выбрать одну из директорий:

  • /docs;
  • /site;
  • /public;
  • /out.

4. Включите GitVerse Pages

Warning

Для корректной работы GitVerse Pages:

  • репозиторий должен быть публичным;
  • в репозитории должен быть включен CI/CD;
  • название аккаунта владельца не должно содержать точки;
  • название репозитория не должно начинаться с точки.

На странице выбранного репозитория перейдите в раздел Настройки → Страницы

Затем:

  1. Включите GitVerse Pages.
  2. Выберите источник Ветка.
  3. Укажите ветку публикации.
  4. При необходимости выберите папку.
  5. Сохраните настройки.

После сохранения автоматически запустится сборка и публикация сайта.

5. Проверьте публикацию

После успешной сборки сайт будет доступен по адресу:

Сайт проекта

https://<owner>.gitverse.site/<repo-name>

Ссылка на сайт также отображается на главной странице репозитория:

Статус публикации и логи

На странице GitVerse Pages можно:

  • проверить статус публикации;
  • открыть логи CI/CD workflow сборки и публикации сайта;
  • повторно опубликовать сайт;
  • снять сайт с публикации.

Если сборка завершилась ошибкой

Проверьте:

  • структуру проекта;
  • выбранную ветку и директорию;
  • конфигурацию _config.yml;
  • используемые плагины и темы;
  • логи CI/CD.

Пользовательские настройки и файлы всегда имеют приоритет над встроенными.

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

Вид графа

Связанные страницы