Pelican, генератор статичних сайтів на основі Python

про Пелікана

У наступній статті ми збираємося подивитися на Пелікана. Це хороший варіант для користувачів Python, які хочуть самостійно розмістити простий веб-сайт або блог. Якщо ви зацікавлені у створенні власного веб -сайту або блогу, у вас сьогодні є багато варіантів. Але якби тільки якщо ви хочете обслуговувати статичні веб -сторінки, цей конструктор статичних веб -сайтів може бути вам корисним. Ці типи додатків використовують шаблони для створення всіх статичних сторінок, які потрібні користувачеві, та зв’язування їх із відповідними метаданими.

Якщо ви використовуєте Python і ви шукаєте щось для створення статичних HTML -сторінок, цей генератор дозволить вам подивитися на внутрішні особливості його роботи. Використання мови, яку ви знаєте, полегшує роботу. Якщо вам не подобається Python, існують інші генератори статичних сайтів, які використовують інші мови.

Pelican - це часто використовуваний генератор статичних сайтів, написаний на Python. Схід безпосередньо підтримує reStructuredText і може підтримувати Markdown, коли необхідний пакет встановлено. Усі завдання виконуються за допомогою інструментів інтерфейсу командного рядка (CLI), що робить його простим для всіх, хто знайомий з ним. Крім того, його простий інструмент швидкого запуску робить створення веб -сайту надзвичайно простим.

Встановлення та основна конфігурація Pelican

Я тестую цю програму на Ubuntu 20.04. Першим кроком, якого слід дотримуватися, буде створити a virtualenv і встановіть Pelican. Це можна зробити, відкривши термінал (Ctrl + Alt + T) і використовуючи в ньому команди:

створення віртуального середовища

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

./venv/bin/pip install --upgrade pip

Після оновлення pip ми тепер можемо встановити Pelican:

Установа "Пелікан"

./venv/bin/pip install pelican

Запустіть команду pelican-quickstart

Після встановлення інструмент CLI для швидкого запуску Pelican створить базовий макет і деякі файли, щоб ми могли розпочати роботу.

Щоб було простіше, під час швидкого запуску я використав значення заголовка та автора та відповів 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 переглянути створений блог.

зразок сторінки, створеної за допомогою Pelican

Додати вміст

Тепер, коли у нас є базовий сайт, ми можемо додати певний вміст. Спочатку, ми створимо файл із назвою Ласкаво просимо у каталозі вмісту (зміст) сайту.

За допомогою нашого улюбленого текстового редактора, ми створимо цей файл із текстом, який відповідає такій структурі:

додати вміст у пелікан

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.).

Після написання файлу, devserver повинен оновитись і створити щось подібне:

додано вітальний файл

Перезавантажте свій тестовий сайт у браузері, щоб побачити зміни.

статична сторінка привітання

Метадані автоматично додавалися на сторінку. Що ще, Пелікан автоматично виявив категорію «Вступ» і додав розділ у верхню навігаційну панель.

Змінити тему

На додаток до всього вищесказаного, ми можемо легко змінити тему. У сховищі Пелікан-теми, можна знайти різні теми, створені користувачами. Тестувати нові теми дуже просто, просто завантажте їх зі сховища, збережіть їх на нашому комп’ютері та у файлі pelicanconf.py додайте наступний рядок із шляхом до теми:

THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"

Девсервер відновить свій вихід. Оновіть веб -сторінку в браузері, щоб побачити нову тему.

Це був короткий короткий вступ до Пелікана. Все це було зроблено на локальній машині. Якщо ви хочете, щоб ваш сайт бачили інші, вам доведеться завантажити попередньо створені файли HTML на сервер. Якщо ви детально подивитесь на вихід швидкий старт пелікану, ви побачите варіанти використання FTP, SSH, S3 і навіть сторінок GitHub.

Він може отримати додаткову інформацію про цей генератор у веб-сайт проекту або у вашому Репозиторій GitHub.


Залиште свій коментар

Ваша електронна адреса не буде опублікований. Обов'язкові для заповнення поля позначені *

*

*

  1. Відповідальний за дані: Мігель Анхель Гатон
  2. Призначення даних: Контроль спаму, управління коментарями.
  3. Легітимація: Ваша згода
  4. Передача даних: Дані не передаватимуться третім особам, за винятком юридичних зобов’язань.
  5. Зберігання даних: База даних, розміщена в мережі Occentus Networks (ЄС)
  6. Права: Ви можете будь-коли обмежити, відновити та видалити свою інформацію.