Pelican, generator statičkih web stranica zasnovan na Pythonu

o Pelicanu

U sljedećem članku ćemo pogledati Pelikana. Ovo je dobra opcija za korisnike Pythona koji žele sami ugostiti jednostavnu web stranicu ili blog. Ako ste zainteresirani za izradu prilagođene web stranice ili bloga, danas imate na raspolaganju mnogo opcija. Ali samo da je tako ako želite posluživati ​​statičke web stranice, ovaj alat za izradu statičkih web stranica može vam biti od koristi. Ove vrste aplikacija koriste predloške za kreiranje svih statičkih stranica koje korisnik želi i povezuju ih s pridruženim metapodacima.

Ako koristite piton i tražite nešto za generiranje statičkih HTML stranica, ovaj generator će vam omogućiti da pogledate unutrašnjost kako radi. Upotreba jezika koji poznajete olakšava. Ako vam se ne sviđa Python, postoje i drugi generatori statičkih web stranica koji koriste druge jezike.

Pelican je često korišteni generator statičkih web stranica napisan na Pythonu. Istok direktno podržava reStructuredText i može podržati Markdown, kada je potreban paket instaliran. Svi se zadaci izvode putem alata sučelja komandne linije (CLI), što olakšava svakome ko je upoznat. Osim toga, njegov jednostavan alat za brzi početak čini stvaranje web stranice iznimno lakim.

Pelican instalacija i osnovna konfiguracija

Testiram ovaj program na Ubuntu 20.04. Prvi korak koji ćete slijediti će biti create a virtualenv i instalirajte Pelican. To se može učiniti otvaranjem terminala (Ctrl + Alt + T) i upotrebom naredbi u njemu:

stvaranje virtualnog okruženja

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Nakon ažuriranja pipa, sada možemo instalirajte Pelican:

Objekat Pelican

./venv/bin/pip install pelican

Pokrenite naredbu pelican-quickstart

Jednom instaliran, Pelican Quick Start CLI Tool će stvoriti osnovni izgled i neke datoteke kako bismo mogli započeti.

Da pojednostavimo stvari, prilikom pokretanja brzog početka koristio sam vrijednosti naslova i autora i odgovorio N do URL prefiksa i paginacije članka. Za ostala pitanja, koristio sam default. Vrlo je lako kasnije promijeniti ove postavke u konfiguracijskoj datoteci. Brzi početak se može pokrenuti sa naredbom:

quickstart pelican

./venv/bin/pelican-quickstart

Kada to završi, možemo promijeniti određene aspekte postavki. Samo moramo otvorite datoteku pelicanconf.py u našem omiljenom uređivaču teksta.

konfiguracijska datoteka

Unutra možemo potražiti liniju:

TIMEZONE = 'Europe/Paris'

I možemo promijenite vremensku zonu zemlje koja vas zanima.

para ažurirajte postavke društvenih veza, morate tražiti varijablu SOCIJALNO en pelicanconf.py. U nju možemo dodati naše veze na sljedeći način:

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

Treba imati na umu da je zarez na kraju važan. Ta zarez pomaže Pythonu da prepozna da je varijabla zapravo skup. Pazite da ga ne izbrišete.

Pokrenite server

Sada kada imamo osnove web stranice, možemo vidjeti da je brzi početak stvorio Makefile s različitim ciljevima. Jedan od njih pravi devserver može pokrenuti razvojni server na našoj mašini kako bismo mogli pregledati sve što stvaramo. CLI naredbe korištene u Makefile -u trebale bi biti dio našeg PATH -a, pa prvo moramo aktivirati virtualenv.

pokrenite server

source ./venv/bin/activate

make devserver

Kad počne, možemo otvorite naš preglednik i idite na URL http://localhost:8000 da vidite blog koji je kreiran.

uzorak stranice kreiran pomoću Pelican -a

Dodajte sadržaj

Sada kada imamo osnovnu web lokaciju, možemo dodati neki sadržaj. Prvo, stvorit ćemo datoteku pod nazivom welcome.rst u direktorijumu sadržaja (sadržaj) stranice.

Uz naš omiljeni uređivač teksta, stvorit ćemo ovu datoteku s tekstom koji slijedi sljedeću strukturu:

dodaj sadržaj u 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.).

Nakon pisanja datoteke, Devserver bi trebao ažurirati i generirati nešto poput ovoga:

dodana datoteka dobrodošlice

Ponovo učitajte svoju testnu stranicu u pregledaču da vidite promjene.

statička stranica dobrodošlice

Metapodaci su automatski dodani na stranicu. Šta više, Pelican je automatski otkrio kategoriju Intro i dodao odjeljak u gornju navigaciju.

Promijenite temu

Pored svega navedenog, možemo lako promijeniti temu. U spremištu Pelikanske teme, možete pronaći različite teme koje su kreirali korisnici. Vrlo je lako testirati nove teme, samo ih morate preuzeti iz spremišta, spremite ih na naše računalo i u datoteku pelicanconf.py dodajte sljedeći redak s putanjom do teme:

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

Devserver će regenerirati svoj izlaz. Ponovo učitajte web stranicu u pregledniku da vidite novu temu.

Ovo je bio kratki uvod u Pelican. Sve je to učinjeno na lokalnoj mašini. Ako želite da drugi vide vašu web lokaciju, morat ćete učitati prethodno generirane HTML datoteke na poslužitelj. Ako detaljno pogledate izlaz datoteke pelikan-brzi početak, vidjet ćete mogućnosti korištenja FTP, SSH, S3, pa čak i stranice GitHub.

Možete više informacija o ovom generatoru potražite u web stranica projekta ili u vašem GitHub spremište.


Ostavite komentar

Vaša e-mail adresa neće biti objavljena. Obavezna polja su označena sa *

*

*

  1. Za podatke odgovoran: Miguel Ángel Gatón
  2. Svrha podataka: Kontrola neželjene pošte, upravljanje komentarima.
  3. Legitimacija: Vaš pristanak
  4. Komunikacija podataka: Podaci se neće dostavljati trećim stranama, osim po zakonskoj obavezi.
  5. Pohrana podataka: Baza podataka koju hostuje Occentus Networks (EU)
  6. Prava: U bilo kojem trenutku možete ograničiti, oporaviti i izbrisati svoje podatke.