find old_content

2026-09-13 19:19:02 +03:00
parent dfdf028104
commit 5c27c9d583
26 changed files with 699 additions and 0 deletions
@@ -0,0 +1,54 @@
+---
+title: "Быстрый старт работы с Pelican"
+date: 2019-03-10T00:00:00+00:00
+description: "описание как быстро настроить и запустить статический генератор сайтов Pelican"
+draft: false
+---
+
+# Быстрый старт
+
+Настоятельно рекомендуем прочитать полную версию документации, но для особо нетерпеливых ниже представлен ряд шагов, чтобы быстро начать работу.
+
+# Подготовка
+
+В системе 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](https://github.com/getpelican/pelican/wiki/Tutorials) wiki Pelican приведены ссылки на опубликованные сообществом руководства.
+
+# Источники
+
+<https://python-scripts.com/virtualenv> <https://docs.getpelican.com/en/stable/quickstart.html>