В версии Publii 0.44 представлена поддержка репозитория Git ™, улучшающая синхронизацию веб-сайта и управление данными.

Примечание: Начиная с версии 0.44, Publii начинает поэтапный отказ от интеграции с GitHub и GitLab. Эти интеграции будут полностью устаревшими с версии 0.46, выпуск которой ожидается в начале 2024 года.

Преимущества Git ™

Git ™, широко используемая система контроля версий, теперь является основной частью процесса синхронизации данных Publii. Благодаря внедрению Git ™ Publii теперь предлагает более надежную и универсальную поддержку различных сервисов репозитория, таких как GitHub, GitLab и Bitbucket, тем самым расширяя возможности для совместимости с пользователями и гибкости в управлении веб-сайтом.

Подробный рабочий процесс

С новым обновлением рабочий процесс Publii оптимизирует обновления веб-сайта с помощью Git ™. Вот как это работает:

1. Извлечение содержимого: Publii изначально выполняет проверку вашего репозитория Git ™, проверяя, соответствует ли содержимое локальной версии в Publii. Этот шаг важен для обеспечения отсутствия расхождений между репозиторием и локальным контентом. Этот процесс проверки имеет решающее значение для предотвращения конфликтов во время синхронизации и поддержания целостности обновлений вашего контента.

2. Переопределение содержимого веб-сайта: При рендеринге веб-сайта содержимое вашей локальной версии веб-сайта имеет приоритет над текущим состоянием в репозитории. Любые обновления или изменения, внесенные вами локально, заменят то, что находится в репозитории.

3. Создание коммита и отправка: После синхронизации создается коммит из файлов, которые были изменены. Затем этот коммит передается обратно в ваш репозиторий Git ™. Этот процесс гарантирует, что ваш репозиторий обновлен с учетом последних изменений, внесенных на ваш веб-сайт.

Важное напоминание: Помните, изменения, внесенные в ваш репозиторий Git ™, не повлияют на содержимое вашего веб-сайта, поскольку они будут переопределены процессом рендеринга Publii и новым коммитом, созданным на основе ваших локальных изменений.

Руководство по настройке

Прежде чем погрузиться в настройки Git ™, важно понять роль каждого поля. Конфигурация, которую вы примените здесь, определит, как Publii взаимодействует с вашим репозиторием Git ™, обеспечивая беспрепятственный доступ к вашему контенту в Интернете.

После выбора "Репозитория Git ™" в качестве типа вашего сервера в настройках сервера перейдите к заполнению сведений о репозитории Git ™:

• URL веб-сайта: URL вашего текущего веб-сайта. Это адрес, по которому ваш сайт будет доступен для широкой публики после развертывания. Убедитесь, что он соответствует домену, который вы планируете использовать. Если вы используете пользовательский домен, этот URL-адрес должен быть именем домена (например, yourwebsite.com).

  Пожалуйста, не забудьте поместить файл CNAME в корневые файлы инструмента файлового менеджера, если вы используете пользовательский домен. Кроме того, если у вас есть файлы, которые Publii не генерирует, но которые вы хотите сохранить во время синхронизации, важно также найти эти файлы в файловом менеджере. Этот шаг гарантирует, что внешние или добавленные вручную файлы не будут перезаписаны или удалены в процессе синхронизации с Publii.

• URL репозитория: веб-адрес вашего репозитория.
• Ветка: "main" или "master" - обычные подозреваемые.
• Имя пользователя: идентификатор, который вы принимаете в своем сервисе Git ™.
• Пароль / токен: секретный ключ или токен личного доступа. Если вы используете 2FA для защиты своей учетной записи, вы должны использовать ранее сгенерированный токен доступа вместо пароля.
• Электронная почта автора коммита: Автор ваших коммитов.
• По умолчанию используетсясообщение о фиксации: "Publii: обновить содержимое".