← Cloudflare Pages / pages / framework-guides

Zola

Zola ↗ это быстрый генератор статических сайтов в виде единого бинарного файла со всем необходимым внутри. В этом руководстве вы создадите новое приложение Zola и развернёте его с помощью Cloudflare Pages. Вы будете использовать zola CLI для создания нового сайта на Zola.

Сначала установить ↗ zola CLI, следуя приведенным ниже инструкциям для вашей операционной системы:

Если вы используете пакетный менеджер Homebrew ↗, выполните brew install в терминале, чтобы установить Zola:

brew install zola

Если вы используете пакетный менеджер Chocolatey ↗, выполните choco install в терминале, чтобы установить Zola:

choco install zola

Если вы используете пакетный менеджер Scoop ↗, выполните scoop install в терминале, чтобы установить Zola:

scoop install zola

Менеджер пакетов вашего дистрибутива Linux может включать Zola. В этом случае её можно установить напрямую через менеджер пакетов дистрибутива, например, с помощью pkg, выполните следующую команду в терминале:

pkg install zola

Если ваш менеджер пакетов не включает Zola или вы хотите загрузить релиз напрямую, обратитесь к Вручную раздел ниже.

Репозиторий Zola на GitHub содержит готовые сборки консольной утилиты Zola для различных операционных систем, которые можно найти на страница Releases ↗.

Подробные инструкции по установке этих версий см. в Руководство по установке Zola ↗.

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

zola init my-zola-project

После выполнения zola init, вам будет предложено ответить на три вопроса:

1. Какой URL-адрес вашего сайта? (https://example.com ↗): Пока это поле можно оставить пустым.

2. Do you want to enable Sass compilation? [Y/n]: Y

3. Do you want to enable syntax highlighting? [y/N]: y

4. Do you want to build a search index of the content? [y/N]: y

Все руководства по фреймворкам предполагают, что у вас уже есть базовое понимание Git ↗. Если вы новичок в Git, обратитесь к этому краткое руководство по Git ↗ о том, как настроить Git на локальном компьютере.

Если вы клонируете по SSH, необходимо сгенерировать ключи SSH ↗ на каждом компьютере, с которого вы отправляете или получаете данные из GitHub.

См. документация GitHub ↗ и Документация Git ↗, где это описано подробнее.

Создайте новый репозиторий GitHub, перейдя по адресу repo.new ↗. После создания нового репозитория перейдите в каталог только что созданного проекта, чтобы подготовить локальное приложение и отправить его в GitHub, выполнив в терминале следующие команды:

git remote add origin https://github.com/<your-gh-username>/<repository-name>
git branch -M main
git push -u origin main

Zola предустановлена в среде сборки Cloudflare Pages, поэтому дополнительная настройка не требуется. При желании можно задать ZOLA_VERSION переменную окружения в разделе Переменные окружения (расширенные) чтобы закрепить определенную версию.

Например, ZOLA_VERSION: 0.19.2.

После настройки сайта вы можете запустить первый деплой. Вы увидите, как Cloudflare Pages собирает ваш сайт с помощью Zola, а затем разворачивает его.

После деплоя сайта вы получите уникальный поддомен для своего проекта на *.pages.dev.

Теперь этот поддомен можно добавить в качестве base_url в вашем config.toml файл.

Например:

# The URL the site will be built for
base_url = "https://my-zola-project.pages.dev"

Каждый раз, когда вы фиксируете новый код в своём сайте на Zola, Cloudflare Pages автоматически пересоберёт и развернёт ваш проект. Вы также получите доступ к развёртывания предпросмотра для новых pull request, чтобы вы могли увидеть, как изменения выглядят на сайте, прежде чем разворачивать их в продакшен.

При работе с Cloudflare Pages вы можете использовать предварительные развёртывания для тестирования изменений перед слиянием с основной веткой. Однако такие развёртывания используют другие URL-адреса (например, https://your-branch-name.my-zola-project.pages.dev), что может вызвать проблемы с загрузкой ресурсов, если ваш base_url задан явно в коде.

Чтобы это исправить, измените команду сборки в конфигурации Cloudflare Pages так, чтобы базовый URL задавался динамически в зависимости от окружения:

if [ "$CF_PAGES_BRANCH" = "main" ]; then zola build; else zola build --base-url $CF_PAGES_URL; fi

Эта команда использует:

• base_url заданы в config.toml при сборке из main ветка
• URL-адрес превью-развёртывания (автоматически предоставляется Cloudflare Pages как $CF_PAGES_URL) для всех остальных веток

После выполнения этого руководства вы успешно развернули свой сайт на Zola на Cloudflare Pages. Чтобы начать работу с другими фреймворками, обратитесь к списку руководств по фреймворкам.