В следующей статье мы познакомимся с Пеликаном. Это хороший вариант для пользователей Python, которые хотят самостоятельно разместить простой веб-сайт или блог. Если вы заинтересованы в создании собственного веб-сайта или блога, сегодня у вас есть множество вариантов. Но если бы только вы хотите обслуживать статические веб-страницы, этот конструктор статических сайтов может быть вам полезен. Эти типы приложений используют шаблоны для создания всех статических страниц, которые хочет пользователь, и связывают их с соответствующими метаданными.
Если вы используете Питон и вы ищете что-то для создания статических HTML-страниц, этот генератор позволит вам взглянуть на то, как он работает, изнутри. Использование знакомого вам языка облегчает задачу. Если вам не нравится Python, есть другие генераторы статических сайтов, использующие другие языки.
Pelican - широко используемый генератор статических сайтов, написанный на Python. Восток напрямую поддерживает ReStructuredText и может поддерживать Markdown, когда установлен требуемый пакет. Все задачи выполняются с помощью инструментов интерфейса командной строки (CLI), что делает его простым для всех, кто с ним знаком. Плюс его простой инструмент быстрого запуска делает создание веб-сайта чрезвычайно простым.
Установка и базовая настройка Пеликана
Тестирую эту программу на Ubuntu 20.04. Первым шагом будет создать virtualenv и устанавливаем Пеликан. Это можно сделать, открыв терминал (Ctrl + Alt + T) и используя в нем команды:
mkdir test-sitio cd test-sitio python3.8 -m venv venv ./venv/bin/pip install --upgrade pip
После обновления пипса теперь мы можем установить Пеликан:
./venv/bin/pip install pelican
Запустите команду pelican-quickstart
После установки Инструмент Pelican Quick Start CLI Tool создаст базовый макет и несколько файлов, чтобы мы могли начать.
Для простоты при запуске быстрого старта я использовал значения заголовка и автора и ответил N к префиксу url и нумерации страниц статьи. По остальным вопросам, я использовал значение по умолчанию. Позже эти параметры очень легко изменить в файле конфигурации. Быстрый старт можно запустить командой:
./venv/bin/pelican-quickstart
Когда это будет сделано, мы сможем изменить некоторые аспекты настроек. Нам просто нужно откройте файл pelicanconf.py в нашем любимом текстовом редакторе.
Внутри мы можем поискать строку:
TIMEZONE = 'Europe/Paris'
И мы можем сменить часовой пояс интересующей вас страны.
к обновить настройки социальных ссылок, вам нужно найти переменную СОЦИАЛЬНЫЕ en pelicanconf.py. В нем мы можем добавить наши ссылки следующим образом:
SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)
Обратите внимание, что запятая в конце важна. Эта запятая помогает Python распознать, что переменная на самом деле является набором. Убедитесь, что вы не удалили его.
Запустить сервер
Теперь, когда у нас есть основы сайта, мы видим, что в ходе быстрого старта был создан Makefile с различными целями. Один из них делает devserver может запустить сервер разработки на нашей машине так что мы можем предварительно просмотреть все, что мы создаем. Команды CLI, используемые в Makefile, должны быть частью нашего PATH, поэтому сначала мы должны активировать virtualenv.
source ./venv/bin/activate make devserver
Когда он начнется, мы сможем откройте наш браузер и перейдите по URL-адресу http://localhost:8000 чтобы увидеть созданный блог.
Добавить содержимое
Теперь, когда у нас есть базовый сайт, мы можем добавить контент. Первый, мы создадим файл с именем добро пожаловать.первый в каталоге содержимого (содержание) сайта.
В нашем любимом текстовом редакторе мы создадим этот файл с текстом, имеющим следующую структуру:
Bienvenid@ a este blog ###################### :date: 20210827 00:03 :tags: bienvenid@ :category: Intro :slug: bienvenida :author: ubunlog :summary: Documento bienvenida Bienvenid@ a este blog de prueba con Pelican. Esta es una pequeña página se va a mostrar como página estática. Pelican analiza automáticamente las líneas de metadatos (fecha, etiquetas, etc.).
После записи файла сервер разработчика должен обновить и сгенерировать что-то вроде этого:
Перезагрузите тестовый сайт в браузере, чтобы увидеть изменения.
Метаданные были автоматически добавлены на страницу. Более того, Пеликан автоматически обнаружил категорию Intro и добавил раздел в верхнюю навигацию..
Сменить тему
Помимо всего вышеперечисленного, мы легко можем сменить тему. В репозитории Пеликан-темы, вы можете найти разные темы, созданные пользователями. Тестировать новые темы очень просто, вам просто нужно скачать их из репозитория, сохраняем их на нашем компьютере и в файле pelicanconf.py добавляем следующую строку с путем к теме:
THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"
Сервер-разработчик восстановит свой вывод. Перезагрузите веб-страницу в браузере, чтобы увидеть новую тему.
Это было краткое знакомство с Пеликаном. Все это было сделано на локальной машине. Если вы хотите, чтобы другие видели ваш сайт, вам нужно будет загрузить предварительно сгенерированные файлы HTML на сервер.. Если вы посмотрите подробно на вывод пеликан, вы увидите варианты использования FTP, SSH, S3 и даже страниц GitHub.
Он может получить больше информации об этом генераторе в сайт проекта или ваши Репозиторий GitHub.