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

Что такое Jekyll?

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

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

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

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

На текущем этапе не поддерживаются.

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

Да, вы можете публиковать 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 %}

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

Info

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

Кэш браузера

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

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

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

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

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

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

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

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

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

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

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

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

Смотри также

Вид графа

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