Как работает автоматическая публикация GitVerse Pages

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

Процесс автоматической сборки

Встроенная сборка выполняется в несколько этапов:

1. Проверка структуры проекта и наличия входных файлов.
2. Подключение пользовательских версий Gemfile, _config.yml, _layouts, если они присутствуют в репозитории.

Если файлы отсутствуют, GitVerse Pages автоматически подставляет стандартные версии из официального репозитория сборщика jekyll-build-pages.

3. Запуск Jekyll со следующими параметрами:

• JEKYLL_ENV=production (по умолчанию);
• включен режим относительных путей (абсолютные пути не поддерживаются);
• используются только плагины, поддерживаемые GitVerse Pages.

4. Генерация статического каталога _site.
5. Публикация результата в объектное хранилище (S3).
6. Раздача контента через CDN и Nginx.

Автоматически создаваемые файлы

В рамках встроенной автоматической сборки GitVerse Pages может создать следующие файлы, если они отсутствуют в репозитории:

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

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

Пример простого блога на Jekyll приведен в разделе практические руководства.

Ограничения автоматической публикации

При использовании встроенной автоматической сборки следует учитывать, что:

• публикуются только статические файлы (HTML, CSS и JavaScript);
• все пути к стилям и скриптам должны быть относительными (через ./);
• темы Jekyll необходимо подключать самостоятельно.