17 lines
8.0 KiB
HTML
17 lines
8.0 KiB
HTML
<!doctype html><html lang=ru dir=ltr><head><meta charset=utf-8><meta name=viewport content="width=device-width"><link rel=icon type=image/ico href=https://gelonet.ru//favicon.ico><link rel=icon type=image/png sizes=16x16 href=https://gelonet.ru//favicon-16x16.png><link rel=icon type=image/png sizes=32x32 href=https://gelonet.ru//favicon-32x32.png><link rel=icon type=image/png sizes=192x192 href=https://gelonet.ru//android-chrome-192x192.png><link rel=apple-touch-icon sizes=180x180 href=https://gelonet.ru//apple-touch-icon.png><meta name=description content="описание как быстро настроить и запустить статический генератор сайтов Pelican"><title>Быстрый старт работы с Pelican | Журнал Стороженко Евгения</title><link rel=canonical href=https://gelonet.ru/posts/quickstart_pelican/><link rel=stylesheet href=/assets/combined.min.a6824bbee0d90d5af09fed9b70395ce7076b615e315037455d903314e96ef91b.css media=all></head><body class=auto><div class=content><header><div class=header><h1 class=header-title>Журнал Стороженко Евгения</h1><div class=flex><p class=small><a href=/>/домашняя</a></p><p class=small><a href=/posts>/записи</a></p><p class=small><a href=/about>/резюме</a></p></div></div></header><main class=main><div class=breadcrumbs><a href=/>Home</a>
|
||
<span class=breadcrumbs-separator>> </span><a href=/posts/>Posts</a>
|
||
<span class=breadcrumbs-separator>> </span><a class=breadcrumbs-current href=/posts/quickstart_pelican/>Быстрый старт работы с Pelican</a></div><div><div class=single-intro-container><h1 class=single-title>Быстрый старт работы с Pelican</h1><p class=single-readtime><time datetime=2019-03-10T00:00:00+00:00>March 10, 2019</time></p></div><div class=single-content><h1 id=быстрый-старт>Быстрый старт</h1><p>Настоятельно рекомендуем прочитать полную версию документации, но для особо нетерпеливых ниже представлен ряд шагов, чтобы быстро начать работу.</p><h1 id=подготовка>Подготовка</h1><p>В системе GNU/Linux Debian Buster по-умолчанию уже устанолен Python 3.7 Установим утилиту для создния виртуального окружения venv.
|
||
<code>$ sudo aptitude install python3-venv</code>
|
||
Он включает в свой состав утилиты pip для установки пакетов</p><p>Создаем каталог в котором будет работать Pelican:
|
||
<code>$ mkdir pelican && cd pelican</code>.</p><p>Создаем внутри каталога виртуальную среду Pytnon <code>$ python3 -m venv pelicanenv</code> и активируем её командой <code>$ source pelicanenv/bin/activate</code></p><h1 id=установка>Установка</h1><p>Устанавливаем Pelican (и дополнительно Markdown) на Python 3.7+, выполнив следующую команду в терминале:
|
||
<code>(pelicanenv) $ pip install pelican[Markdown]</code></p><h1 id=создание-проекта>Создание проекта</h1><p>Выбираем имя для проекта и создаем каталог с соответствующим именем для сайта и переходим в этот каталог:
|
||
<code>(pelicanenv) $ mkdir -p ./projects/yoursite.ru (pelicanenv) $ cd ./projects/yoursite.ru</code></p><p>Дальше создаем основу для проекта с помощью команды <code>pelican-quickstart</code>. Эта команда задаст несколько вопросов о создаваемом сайте. На вопрос о URL адресе сайта следует ответить в том же виде как будет отображено в примере <a href=http://yoursite.ru>http://yoursite.ru</a></p><h1 id=создаем-статью>Создаем статью</h1><p>Для того чтобы запустить Pelican потребуется создать хотя бы одну статью. Для этого в любом тектосовм редакторе создаем файл со следующим cодержимым:
|
||
`Title: Мой Первый Отзыв
|
||
Date: 2020-05-04 10:20
|
||
Category: Обзор</p><p>Ниже приведен обзор моей любимой механической клавиатуры.`</p><p>Поскольку эта статья для примера рассматривает работу с данными в формате Markdown, то сохранить его нужно как <code>./projects/yoursite.ru/content/keyboard-review.md</code>.</p><h1 id=генерируем-сайт>Генерируем сайт</h1><p>В корневом каталоге проекта <code>./projects/yoursite.ru/</code>выполните pelican-команду для создания сайта:
|
||
<code>(pelicanenv) $ pelican content</code></p><p>В результате выполенния команды сайт был создан внутри каталога <code>./projects/yoursite.ru/output</code>. В процесе работы могут отобразиться предупреждения, относящееся к RSS лентам, но это нормально при локальном развертывании и можно пока не обращать на них внимание.</p><h1 id=предварительный-просмотр-сайта>Предварительный просмотр сайта</h1><p>Открываем сеанс терминала, перейдим в корневой каталог проекта <code>./projects/yoursite.ru/</code>и выполняем команду для запуска веб-сервера Pelican:
|
||
<code>(pelicanenv) pelican --listen</code></p><p>Теперь просмотреть сгенерированный сайт можно перейдя на http://localhost:8000/ в браузере.</p><p>Более подробная информация содержится вдокументации, продолжайте изучать её. Так же на странице <a href=https://github.com/getpelican/pelican/wiki/Tutorials>Tutorials</a> wiki Pelican приведены ссылки на опубликованные сообществом руководства.</p><h1 id=источники>Источники</h1><p><a href=https://python-scripts.com/virtualenv>https://python-scripts.com/virtualenv</a>
|
||
<a href=https://docs.getpelican.com/en/stable/quickstart.html>https://docs.getpelican.com/en/stable/quickstart.html</a></p></div><div class=single-pagination><hr><div class=flex><div class=single-pagination-prev><div class=single-pagination-container-prev><div class=single-pagination-text>←</div><div class=single-pagination-text><a href=/posts/placeholder-text/>Placeholder Text</a></div></div></div><div class=single-pagination-next><div class=single-pagination-container-next><div class=single-pagination-text><a href=/posts/debian/>Сохранение и перенос настроек на новую установку GNU/Debian Linux</a></div><div class=single-pagination-text>→</div></div></div></div><hr></div><div class=back-to-top><a href=#top>back to top</a></div></div></main></div><footer><p>Powered by
|
||
<a href=https://gohugo.io/>Hugo</a>
|
||
and
|
||
<a href=https://github.com/tomfran/typo>tomfran/typo</a></p></footer></body><script>function isAuto(){return document.body.classList.contains("auto")}function setTheme(){if(!isAuto())return;document.body.classList.remove("auto");let e="light";window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches&&(e="dark"),document.body.classList.add(e)}function invertBody(){document.body.classList.toggle("dark"),document.body.classList.toggle("light")}isAuto()&&window.matchMedia("(prefers-color-scheme: dark)").addListener(invertBody),setTheme()</script></html> |