Часто задаваемые вопросы — GitVerse Pages

Данный раздел отвечает на распространенные вопросы о сервисе публикации статических сайтов GitVerse Pages.

Что такое Jekyll?

Jekyll — это популярный генератор статических сайтов. Он преобразует Markdown-файлы и Liquid-шаблоны в готовую HTML-разметку. GitVerse Pages использует Jekyll по умолчанию при автоматической публикации из ветки.

Более подробную информацию см. в документации Jekyll.

Можно ли отключить работу генератора Jekyll, если у меня уже есть готовая статика?

Да. Добавьте файл .nojekyll в корень репозитория. При наличии этого файла содержимое, не относящееся к специфике Jekyll, будет проигнорировано, и файлы опубликуются без обработки генератором.

Поддерживаются ли пользовательские домены?

На текущем этапе пользовательские домены не поддерживаются. Все сайты GitVerse Pages доступны по домену *.gitverse.site.

Можно ли использовать Hugo, Next.js или другой фреймворк?

Да, вы можете публиковать GitVerse Pages с использованием других генераторов и фреймворков. Для этого настройте публикацию через собственный CI/CD workflow. Подробнее см. в разделе Публикация из workflow.

Как обновляется сайт после изменений?

При использовании автоматической публикации из ветки каждый коммит в выбранной ветке автоматически запускает пересборку и обновление сайта. При публикации через workflow обновление происходит при запуске соответствующего CI/CD workflow.

Как понять, почему сборка упала?

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

Ошибка на этапе деплоя, что делать?

Попробуйте заново опубликовать Страницу:

  1. Перейдите в Настройки → Страницы.
  2. Перезапустите публикацию, нажав на кнопку Опубликовать.
  3. Если публикация снова завершилась с ошибкой, напишите в поддержку.

Где смотреть логи сборки?

После неудачной сборки в интерфейсе GitVerse Pages вы можете найти подробную информацию об ошибках:

  1. Откройте Настройки репозитория → вкладка Страницы.
  2. Перейдите по ссылке Открыть запуск сборки.
  3. Посмотрите логи выполнения публикации.

Либо:

  1. Перейдите на вкладку CI/CD.
  2. Найдите служебный workflow pages-build-deploy.

Логи сборки содержат информацию о каждом этапе процесса: от клонирования репозитория до раздачи контента через CDN.

Как собрать проект локально?

Локальная сборка позволяет проверить результат перед публикацией и отладить проблемы в вашей среде разработки.

  1. Если в проекте нет файлов Gemfile или _config.yml либо стандартных шаблонов в папке _layouts, GitVerse автоматически добавляет стандартные версии файлов из экшена по сборке Страниц.

    Скопируйте файл Gemfile или _config.yml в корневую директорию вашего проекта, а шаблон default.html поместите в папку _layouts.

  2. Соберите проект:

# Установка зависимостей
bundle install
 
# Локальная сборка
bundle exec jekyll build
 
# Запуск локального сервера для проверки
bundle exec jekyll serve

Типичные ошибки и решения

Ошибки в конфигурационном файле _config.yml

Ошибка: YAML syntax error
Решение: Проверьте синтаксис YAML, убедитесь, что отступы корректны и используются пробелы, а не табуляции.

# Правильно
title: Мой блог
email: your-email@example.ru
 
# Неправильно
title: Мой блог
 email: your-email@example.ru

Проблемы с путями к файлам

Ошибка: Could not read file
Решение: Проверьте, что все пути указаны относительно корня проекта. Используйте относительные пути вместо абсолютных.

# Правильно
assets:
  css: ./assets/css/style.css
 
# Неправильно
assets:
  css: /assets/css/style.css  # Абсолютный путь может вызвать проблемы

Ошибки в шаблонах Liquid

Ошибка: Liquid syntax error
Решение: Проверьте синтаксис Liquid-шаблонов. Убедитесь, что все теги закрыты корректно.

<!-- Правильно -->
{% if page.title %}
  <h1>{{ page.title }}</h1>
{% endif %}
 
<!-- Неправильно -->
{% if page.title }
  <h1>{{ page.title }}</h1>
{% endif %}

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

Info

В этом разделе перечислены наиболее распространенные причины ошибки 404 при работе с GitVerse Pages и способы их устранения. Ошибка 404 означает, что запрашиваемая страница не найдена.

Кэш браузера

Если сайт недоступен и отображается ошибка 404, попробуйте очистить кэш браузера. Инструкции по очистке кэша можно найти в документации вашего браузера. Кэш может хранить устаревшие версии страниц, что приводит к неправильному отображению контента.

Главная страница сайта

GitVerse Pages использует один из следующих файлов в качестве точки входа сайта:

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

Проверьте следующее:

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

Содержимое директории

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

Статус публикации сайта

Проверьте статус публикации сайта — он должен быть успешно завершен. Сайт может быть недоступен по следующим причинам:

  • публикации сайта еще не завершилась или завершилась с ошибкой;
  • изменили публичность репозитория на приватный;
  • сменили название репозитория;
  • поменяли имя пользователя;
  • по другим причинам, связанным с настройками репозитория или публикации. Полностью см. Необходимые условия для запуска GitVerse Pages.

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

Устранение других ошибок

Если вы столкнулись с другой проблемой в работе GitVerse Pages или платформы в целом, при обращении в службу поддержки может потребоваться записать HAR-файл (HTTP Archive):

HAR-файлы помогают нашей службе поддержки диагностировать проблемы с сетевыми запросами, отлаживать ситуации с некорректной работой страниц или анализировать ошибки, возникающие при взаимодействии с платформой.

Смотри также

Вид графа

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