Введение
Pelican это библиотека на python, которая очень просто решает задачу генерации статических сайтов. Соотвественно, эта статья для тех, кто:
- знает, что python это язык программирования, в состоянии установить его и библиотеку Pelican на компьютер,
- имеет о чем рассказать миру, т.е. хочет вести собственный блог, но почему-то не удовлетворен рамками Facebook, Twitter и пр.,
- стремится к простоте, а значит понимает, что если нечто имеет неприятное по звучанию название, например Drupal, Joomla, Wordpress, ... то понятным и управляемым это нечто быть не может. А значит рано или поздно обязательно познакомит Вас с массой проблем различной сложности.
Цель публикации - показать, что создание сайта (типа личный блог) с помощью Pelican это просто. Но поскольку любоваться собственным сайтом в одиночку не очень интересно, в данной публикации по шагам рассмотрен весь жизненный цикл разработки - от подготовки проекта до размещения сайта в интернете.
Шаг 0.
Предполагается , что на Вашем компьютере уже установлены python и Pelican. Если нет - вот ссылки на дистрибутивы и инструкции по установке для Python и для Pelican
Шаг 1. Создание проекта сайта
В самом простом варианте - на диске нужно создать каталог в котором будет хранится содержимое проекта нашего сайта и запустить в каталоге консольную команду быстрой установки:
pelican-quickstart
С опытом станет очевидно, что такая организация проекта влечет некоторые неудобства при его сопровождении. Чтобы этого избежать, рекомендую прочитать эту статью
Запущенная программа в диалоговом режиме попросит Вас задать некоторые параметры проекта. Что они означают, можно посмотреть здесь. В принципе, можно не заморачиваться и на все вопросы где предлагается выбор да/нет применить значения по умолчанию (просто нажимать Enter).
После завершения работы установщика в каталоге сайта будет создано несколько файлов и папок. Сейчас нас интересует только одна папка - content. В нее мы будем сохранять контент (тексты статей и изобращения) нашего сайта.
Шаг 2. Написание статей для сайта
С точки зрения Pelican, статья сайта - это обычный текстовый файл, содержащий 1) текст и 2) команды управления, отвечающие за внешний вид статьи на странице сайта. Поэтому, публикации можно писать в любом текстовом редакторе, например, Sublime Text.
Далее, поясним так. Команды управления в статье могут быть одного из двух форматов restructuredtext: или markdown:. Разница между ними небольшая, далее в статье будет рассмотриваться формат restructuredtext (просто потому, что больше нравится).
Соотвественно файлы публикаций для нашего сайта мы должны сохранять в каталоге проекта content как текстовые файлы с расширением rst. Каждая статья размещается в отдельном файле.
Файл каждой статьи должен начинаться примерно с такого блока
Название статьи
###############
:tags: python, pelican
:category: Инструменты разработки
:slug: python-pelican
:summary: Основы работы c генератором статических сайтов pelican
:date: 2016-05-24
Текст статьи ....
В принципе обязательным является только ":date:". Остальные команды включаете в статью по своему желанию.
- ":slug:" - URL статьи.
- ":tag:" и ":category:" - помогут генератору сайта правильно сгруппировать статьи и быстро находить их на сайте
Формат restructuredtext очень гибкий и позволяет вставлять в текст статьи изображения, формулы, блоки кода, внутренние и внешние ссылки и многое другое. Подробнее ознакомиться с возможностями формата можно на этом сайте:
Шаг 3. Генерация и просмотр сайта
Итак, Вы создали первую статью и сохранили ее в папке content. Чтобы посмотреть как будет выглядеть сайт нужно из каталога проекта выполнить две консольные команды.
- Запуск генератора сайта
pelican content -s publishconf.py
Сгенерирированные страницы сайта будут находиться в каталоге output Вашего проекта.
- Запуск локального сервера
cd output
python -m SimpleHTTPServer
После этого наш сайт станет доступен в браузере по адресу http://localhost:8000
Шаг 4. Размещение сайта в интернете
Самый простой способ размещения полученного сайта в интернете - закачать его на один из git репозиториев, например Github, Bitbucket. Как это сделать, можно прочитать здесь.
Итог
В отведенное время (10 минут) уложились - блог создан и опубликован в интернете. Однако, чтобы его посещали кто-нибудь кроме Ваших родных и друзей, необходимо учесть еще 2 "мелочи": контент и дизайн.
Вопрос раскрутки сайта, который также достаточно сильно влияет на его посещаемость - это "алхимия", которая выходит за тематику этого блога.
Создавать нормальный контент для сайта Вас вряд ли кто-то научит. А вот как настроить дизайн своего сайта и удобно добавлять в него (править) статьи - читайте здесь.