Pelican, un generator de site static bazat pe Python

despre Pelican

În articolul următor vom arunca o privire la Pelican. Aceasta este o opțiune bună pentru utilizatorii Python care doresc să găzduiască un site web sau un blog simplu. Dacă sunteți interesat să creați un site sau blog personalizat, aveți astăzi multe opțiuni disponibile. Dar dacă ar fi dacă doriți să difuzați pagini web statice, acest constructor static de site-uri vă poate fi util. Aceste tipuri de aplicații folosesc șabloane pentru a crea toate paginile statice dorite de utilizator și pentru a le conecta la metadatele asociate.

Dacă utilizați Piton și căutați ceva pentru a genera pagini HTML statice, acest generator vă va permite să aruncați o privire asupra internelor cum funcționează. Folosirea unui limbaj pe care îl cunoașteți îl face mai ușor. Dacă nu vă place Python, există și alte generatoare de site statice care folosesc alte limbi.

Pelican este un generator de site static folosit în mod obișnuit, scris în Python. Est susține direct reStructuredText și poate sprijini Markdown, când este instalat pachetul necesar. Toate sarcinile sunt efectuate prin intermediul instrumentelor de interfață din linia de comandă (CLI), ceea ce îl face simplu pentru oricine este familiarizat cu acesta. În plus, instrumentul său simplu de pornire rapidă facilitează crearea unui site web.

Instalare Pelican și configurație de bază

Testez acest program pe Ubuntu 20.04. Primul pas de urmat va fi creați un virtualenv și instalați Pelican. Acest lucru se poate face deschizând un terminal (Ctrl + Alt + T) și folosind comenzile din acesta:

crearea mediului virtual

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

După actualizarea pip, putem acum instalează Pelican:

Facilitatea pelicanului

./venv/bin/pip install pelican

Rulați comanda pelican-quickstart

Odată instalat, instrumentul Pelican Quick Start CLI va crea aspectul de bază și câteva fișiere, astfel încât să putem începe.

Pentru a simplifica lucrurile, când am rulat pornirea rapidă, am folosit valorile pentru titlu și autor și am răspuns N la prefixul URL și paginarea articolului. Pentru restul întrebărilor, Am folosit implicit. Este foarte ușor să modificați aceste setări în fișierul de configurare ulterior. Pornirea rapidă poate fi executată cu comanda:

pelican rapid

./venv/bin/pelican-quickstart

Când se termină, putem schimba anumite aspecte ale setărilor. Trebuie doar deschideți fișierul pelicanconf.py în editorul nostru de text preferat.

Fișier de configurare

În interior putem căuta linia:

TIMEZONE = 'Europe/Paris'

Și putem treceți la fusul orar al țării care vă interesează.

la actualizați setările legăturilor sociale, trebuie să căutați variabila SOCIAL en pelicanconf.py. În acesta putem adăuga linkurile noastre după cum urmează:

SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)

Trebuie să rețineți că virgula de la sfârșit este importantă. Această virgulă îl ajută pe Python să recunoască faptul că variabila este de fapt un set. Asigurați-vă că nu îl ștergeți.

Porniți serverul

Acum, că avem elementele de bază ale unui site, putem vedea că pornirea rapidă a creat un Makefile cu diverse scopuri. Una dintre ele face devserver poate porni un server de dezvoltare pe mașina noastră astfel încât să putem previzualiza tot ceea ce creăm. Comenzile CLI utilizate în Makefile ar trebui să facă parte din PATH-ul nostru, deci mai întâi trebuie să activăm virtualenv.

pornește serverul

source ./venv/bin/activate

make devserver

Când începe, putem deschideți browserul și accesați adresa URL http://localhost:8000 pentru a vedea blogul creat.

eșantion de pagină creat cu Pelican

Adauga continut

Acum că avem un site de bază, putem adăuga conținut. Primul, vom crea un fișier numit bun venit.prima în directorul de conținut (conţinut) a site-ului.

Cu editorul nostru de text preferat, vom crea acest fișier cu un text care urmează următoarea structură:

adăugați conținut în 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.).

După scrierea fișierului, devserver-ul ar trebui să actualizeze și să genereze așa ceva:

fișier de bun venit adăugat

Reîncărcați site-ul de testare în browser pentru a vedea modificările.

pagină de întâmpinare statică

Metadatele au fost adăugate automat la pagină. Mai mult, Pelican a detectat automat categoria Intro și a adăugat secțiunea la navigarea de sus.

Schimba subiectul

Pe lângă toate cele de mai sus, putem schimba cu ușurință subiectul. În depozit Pelican-teme, puteți găsi diferite teme create de utilizatori. Este foarte ușor să testați teme noi, trebuie doar să le descărcați din depozit, salvați-le pe computerul nostru și în fișierul pelicanconf.py adăugați următoarea linie cu calea către temă:

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

Devserver-ul își va regenera ieșirea. Reîncărcați pagina web în browser pentru a vedea noua temă.

Aceasta a fost o mică introducere rapidă la Pelican. Toate acestea au fost făcute pe o mașină locală. Dacă doriți ca alții să vă vadă site-ul, va trebui să încărcați fișierele HTML pre-generate pe un server. Dacă vă uitați în detaliu la rezultatul pelican-pornire rapidă, veți vedea opțiuni pentru a utiliza FTP, SSH, S3 și chiar paginile GitHub.

Se poate obțineți mai multe informații despre acest generator în site-ul proiectului sau în dumneavoastră Depozitul GitHub.


Lasă comentariul tău

Adresa ta de email nu va fi publicată. Câmpurile obligatorii sunt marcate cu *

*

*

  1. Responsabil pentru date: Miguel Ángel Gatón
  2. Scopul datelor: Control SPAM, gestionarea comentariilor.
  3. Legitimare: consimțământul dvs.
  4. Comunicarea datelor: datele nu vor fi comunicate terților decât prin obligație legală.
  5. Stocarea datelor: bază de date găzduită de Occentus Networks (UE)
  6. Drepturi: în orice moment vă puteți limita, recupera și șterge informațiile.