/main/startup-pelican

Как я поднял блог с помощью Pelican

Имеем на входе:

  • Старый блог на Jekyll
  • Уже готовый дизайн(html+css)
  • Знания Python, Jekyll, Django и Jinja


Почему я выбрал Pelican:

  • Свежий проект, сообщество активно контрибьютит
  • Страницы генерируются на основе markdown, как и Jekyll
  • В темплейтах используется Jinja2


Мой HowTo:

  1. Делаем первый шаг отсюда. Устанавливаем Pelican, дополнительные пакеты и выполняем:
    pelican-quickstart
  1. После создания минимальной структуры проекта я полез в pelicanconf.py. Помимо основных настроек я прописал свой, к примеру TELEGRAM_USERNAME. Вид моего конфига:
    AUTHOR = "dkurchigin"
    SITENAME = "Типичный Python разработчик"
    SITESUBTITLE = "О программировании, мелочах жизни и многом другом..."
    SITEURL = "https://dkurchigin.github.io/"
    PATH = "content"
    TIMEZONE = "Europe/Moscow"
    DEFAULT_LANG = "Russian"
    TELEGRAM_USERNAME = "dirty_rotten_imb"
    GITHUB_USERNAME = "dkurchigin"
    EMAIL = "kurchigin.dmitry@yandex.ru"
    DEFAULT_PAGINATION = 10
    THEME = ""
  1. Для смены стандартной схемы создал следующую структуру в корне проекта

pelican_structure

  1. Подсмотреть базовый синтаксис и логику темплейтов можно в стандартной теме.

  2. Для локального дебага делаю make html, а затем make serve.

  3. Для публикации на Github Pages делаю так:

    make html
    ghp-import output -b gh-pages
    git push origin gh-pages
  1. В настройках репозитория во вкладке Pages указываю, что необходимо забирать контент из ветки gh-pages:

github_pages_settings

  1. ENJOY!



17.07.2023
/main/startup-pelican