Как работает автоматическая публикация GitVerse Pages
Info
Этот раздел описывает встроенный механизм автоматической сборки и публикации GitVerse Pages при использовании источника «Ветка».
Автоматическая публикация используется, когда GitVerse Pages настроен на публикацию содержимого репозитория напрямую из выбранной ветки и папки, без использования пользовательских workflow. В этом режиме применяется встроенный процесс сборки на основе Jekyll.
Процесс автоматической сборки
Встроенная сборка выполняется в несколько этапов:
- Проверка структуры проекта и наличия входных файлов.
- Подключение пользовательских версий
Gemfile,_config.yml,_layouts, если они присутствуют в репозитории.
Если файлы отсутствуют, GitVerse Pages автоматически подставляет стандартные версии из официального репозитория сборщика
jekyll-build-pages.
- Запуск Jekyll со следующими параметрами:
JEKYLL_ENV=production(по умолчанию);- включен режим относительных путей (абсолютные пути не поддерживаются);
- используются только плагины, поддерживаемые GitVerse Pages.
- Генерация статического каталога
_site. - Публикация результата в объектное хранилище (S3).
- Раздача контента через CDN и Nginx.
Автоматически создаваемые файлы
В рамках встроенной автоматической сборки GitVerse Pages может создать следующие файлы, если они отсутствуют в репозитории:
| Файл | Условие создания | Назначение |
|---|---|---|
Gemfile | при отсутствии | Подключение Jekyll и поддерживаемых плагинов |
_config.yml | при отсутствии | Базовая конфигурация сайта, включая относительные пути |
_layouts/default.html | при отсутствии | Основной макет страниц при генерации Jekyll |
Пользовательские файлы всегда имеют приоритет над автоматически создаваемыми.
Если требуется изменить конфигурацию сборки или использовать собственную тему, достаточно добавить соответствующие файлы в репозиторий.
Пример простого блога на Jekyll приведен в разделе практические руководства.
Ограничения автоматической публикации
При использовании встроенной автоматической сборки следует учитывать, что:
- публикуются только статические файлы (HTML, CSS и JavaScript);
- все пути к стилям и скриптам должны быть относительными (через
./); - темы Jekyll необходимо подключать самостоятельно.