Быстрый старт

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

Подготовка

В системе GNU/Linux Debian Buster по-умолчанию уже устанолен Python 3.7 Установим утилиту для создния виртуального окружения venv. $ sudo aptitude install python3-venv Он включает в свой состав утилиты pip для установки пакетов

Создаем каталог в котором будет работать Pelican: $ mkdir pelican && cd pelican.

Создаем внутри каталога виртуальную среду Pytnon $ python3 -m venv pelicanenv и активируем её командой $ source pelicanenv/bin/activate

Установка

Устанавливаем Pelican (и дополнительно Markdown) на Python 3.7+, выполнив следующую команду в терминале: (pelicanenv) $ pip install pelican[Markdown]

Создание проекта

Выбираем имя для проекта и создаем каталог с соответствующим именем для сайта и переходим в этот каталог: (pelicanenv) $ mkdir -p ./projects/yoursite.ru (pelicanenv) $ cd ./projects/yoursite.ru

Дальше создаем основу для проекта с помощью команды pelican-quickstart. Эта команда задаст несколько вопросов о создаваемом сайте. На вопрос о URL адресе сайта следует ответить в том же виде как будет отображено в примере http://yoursite.ru

Создаем статью

Для того чтобы запустить Pelican потребуется создать хотя бы одну статью. Для этого в любом тектосовм редакторе создаем файл со следующим cодержимым: `Title: Мой Первый Отзыв Date: 2020-05-04 10:20 Category: Обзор

Ниже приведен обзор моей любимой механической клавиатуры.`

Поскольку эта статья для примера рассматривает работу с данными в формате Markdown, то сохранить его нужно как ./projects/yoursite.ru/content/keyboard-review.md.

Генерируем сайт

В корневом каталоге проекта ./projects/yoursite.ru/выполните pelican-команду для создания сайта: (pelicanenv) $ pelican content

В результате выполенния команды сайт был создан внутри каталога ./projects/yoursite.ru/output. В процесе работы могут отобразиться предупреждения, относящееся к RSS лентам, но это нормально при локальном развертывании и можно пока не обращать на них внимание.

Предварительный просмотр сайта

Открываем сеанс терминала, перейдим в корневой каталог проекта ./projects/yoursite.ru/и выполняем команду для запуска веб-сервера Pelican: (pelicanenv) pelican --listen

Теперь просмотреть сгенерированный сайт можно перейдя на http://localhost:8000/ в браузере.

Более подробная информация содержится вдокументации, продолжайте изучать её. Так же на странице Tutorials wiki Pelican приведены ссылки на опубликованные сообществом руководства.

Источники

https://python-scripts.com/virtualenv https://docs.getpelican.com/en/stable/quickstart.html

Выбор генератора статического сайта

Анализ того ресурса, что размещен на хостинге и называется моим сайтом, показал что я замечательно и без проблем живу на flat cms Grav (плоская CMS без базы данных). При этом я здорово сэкономил на хостинге. Мой месячная абонплата на jino.ru не дотягивала даже до 80 рублей. Поэтому мне показалочь логичным сделать следующий шаг и перейти на полностью статический сайт генерируемый из текстовых файлов (мне понравился язык разметки Markdown), хранимых в каком-либо облаке, например на GitHub.

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

1. Реализация на Python. Для работы и на ноутбуке с GNU\Linux и на домашнем компе с Windows 10. Опять же с исследовательскими целями полезно работать с инструментом написанном на Python.
2. Работа с данными в файлах Markdown. Это удобный язык разметки, позволяющий легко реализовывать все нужные мне средства орагнизации текста.
3. Работа с шаблонизатором Jinja2. Удобный и мощный шаболнизатор. Понравился мне он, да и папа мой называл меня в детстве Джинджя.
4. Возможность работы с плагинами.

В итоге непродолжительных поисков нашёл в сети сайт https://www.staticgen.com/ и на нем по указанным параметрам отобрал вот такое вот решение: https://blog.getpelican.com/ https://github.com/getpelican/ http://www.pelicanthemes.com/