Часто задаваемые вопросы (FAQ)

Что такое Jekyll?

Популярный генератор статических сайтов https://jekyllrb.com/

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

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

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

На текущем этапе не поддерживаются. Запланировано к реализации в Q1 2026, появится поддержка CNAME и необходимые настройки.

Можно ли создать страницу с привязкой только к пользователю username.gitverse.site?

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

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

По умолчанию сейчас поддерживается только Jekyll.
В ближайшем релизе мы дадим возможность публиковать GitVerse Pages, используя свои workflow.

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

Каждый коммит в выбранной ветке автоматически запускает пересборку и обновление сайта.

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

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

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

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

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

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

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

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

Либо:

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

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

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 %}

Смотри также

• Документация Jekyll;
• Справочная документация.