INTEGRITY Документация

Pelican

Pelican это генератор статических сайтов, написанный на Python. С Pelican вы можете писать контент прямо в любимом редакторе в форматах reStructuredText или Markdown.

Создайте проект Pelican

Для начала создайте директорию проекта Pelican. cd в новый каталог и выполните:

python3 -m pip install pelican

Затем выполните:

pip freeze > requirements.txt

Создайте в своём проекте каталог с именем content:

mkdir content

Это имя директории, которое вы укажете в команде сборки.

Прежде чем продолжить

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

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

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

Создайте репозиторий GitHub

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

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

Развернуть с помощью Cloudflare Pages

Чтобы развернуть сайт в Pages:

  1. На панели управления Cloudflare перейдите к разделу Workers & Pages страницу.

    Перейдите в Workers & Pages ↗
  2. Выберите Создать приложение.

  3. Выберите Pages на вкладке.

  4. Выберите Импорт существующего репозитория Git.

  5. Выберите созданный вами новый репозиторий GitHub, а затем нажмите Начало настройки.

  6. В Настройка сборок и деплоев раздел и укажите следующую информацию:

Параметр конфигурацииЗначение
Продакшен-веткаmain
Команда сборкиpelican content
Директория сборкиoutput
  1. Выберите Переменные окружения (расширенные) и задайте PYTHON_VERSION переменную со значением 3.7.

Полное руководство по развёртыванию первого сайта на Cloudflare Pages см. в Руководство по началу работы.

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

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

Подробнее

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