Отладка ошибок сборки

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

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

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

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

Ошибки в конфигурационном файле _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 %}

Полезные советы

Используйте локальную сборку для тестирования

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

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

Проверка синтаксиса

Используйте специализированные инструменты для проверки:

# Проверка YAML
python -m yaml your_config.yml
 
# Проверка Markdown
markdownlint *.md

Смотри также

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