Pelican, en Python-baserad statisk platsgenerator

om Pelican

I nästa artikel kommer vi att titta på Pelican. Detta är ett bra alternativ för Python-användare som vill vara värd för en enkel webbplats eller blogg. Om du är intresserad av att skapa en anpassad webbplats eller blogg har du många alternativ tillgängliga idag. Men om bara om du vill visa statiska webbsidor kan den här statiska webbplatsbyggaren vara användbar för dig. Dessa typer av applikationer använder mallar för att skapa alla statiska sidor som användaren vill ha och länka dem med tillhörande metadata.

Om du använder Python och du letar efter något för att generera statiska HTML -sidor, denna generator låter dig ta en titt på det inre av hur det fungerar. Att använda ett språk du känner gör det lättare. Om du inte gillar Python finns det andra statiska webbplatsgeneratorer som använder andra språk.

Pelican är en vanlig statisk platsgenerator skriven i Python. Öster stöder direkt ReStructuredText och kan stödja Markdown, när det paket som krävs är installerat. Alla uppgifter utförs via kommandoradsgränssnittsverktyg (CLI), vilket gör det enkelt för alla som känner till det. Plus det enkla snabbstartverktyget gör det mycket enkelt att skapa en webbplats.

Pelikaninstallation och grundkonfiguration

Jag testar det här programmet på Ubuntu 20.04. Det första steget att följa blir skapa en virtualenv och installera Pelican. Detta kan göras genom att öppna en terminal (Ctrl + Alt + T) och använda kommandona i den:

skapande av den virtuella miljön

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Efter att ha uppdaterat pip kan vi nu installera Pelican:

Pelikananläggning

./venv/bin/pip install pelican

Kör kommandot pelikan-snabbstart

När den har installerats, Pelican Quick Start CLI Tool skapar den grundläggande layouten och några filer så att vi kan komma igång.

För att hålla sakerna enkla använde jag värdena för titeln och författaren när jag startade snabbstarten och svarade N till url -prefixet och paginering av artikeln. För resten av frågorna, jag använde standard. Det är mycket enkelt att ändra dessa inställningar i konfigurationsfilen senare. Snabbstart kan köras med kommandot:

snabbstart pelikan

./venv/bin/pelican-quickstart

När det är klart kan vi ändra vissa aspekter av inställningarna. Vi måste bara öppna filen pelicanconf.py i vår favorittextredigerare.

konfigurationsfil

Inuti kan vi leta efter linjen:

TIMEZONE = 'Europe/Paris'

Och vi kan ändra till tidszonen i det land som intresserar dig.

till uppdatera sociala länkinställningar, du måste leta efter variabeln SOCIAL en pelicanconf.py. I den kan vi lägga till våra länkar enligt följande:

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

Du bör notera att kommatecken i slutet är viktigt. Denna komma hjälper Python att inse att variabeln faktiskt är en uppsättning. Se till att du inte tar bort det.

Starta servern

Nu när vi har grunderna för en webbplats kan vi se att snabbstarten skapade en Makefile med olika syften. En av dem gör devserver kan starta en utvecklingsserver på vår maskin så att vi kan förhandsgranska allt vi skapar. CLI -kommandona som används i Makefile ska vara en del av vår PATH, så först vi måste aktivera virtualenv.

starta servern

source ./venv/bin/activate

make devserver

När det börjar kan vi öppna vår webbläsare och gå till URL: en http://localhost:8000 för att se bloggen som har skapats.

exempelsida skapad med Pelican

Lägg till innehåll

Nu när vi har en grundläggande webbplats kan vi lägga till lite innehåll. Först, vi skapar en fil som heter välkommen. första i innehållskatalogen (innehåll) på webbplatsen.

Med vår favorittextredigerare, vi kommer att skapa den här filen med en text som följer följande struktur:

lägg till innehåll i pelikan

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

Efter att ha skrivit filen, devserver bör uppdatera och generera något sådant här:

välkomstfil tillagd

Ladda om din testwebbplats i webbläsaren för att se ändringarna.

statisk välkomstsida

Metadata lades automatiskt till sidan. Vad mer, Pelican upptäckte automatiskt Intro -kategorin och lade till avsnittet i den översta navigeringen.

Byta ämne

Förutom allt ovan kan vi enkelt byta ämne. I förvaret Pelikan-teman, kan du hitta olika teman som användare har skapat. Det är väldigt enkelt att testa nya teman, du behöver bara ladda ner dem från förvaret, spara dem på vår dator och i filen pelicanconf.py lägg till följande rad med sökvägen till temat:

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

Devservern kommer att återskapa sin utdata. Ladda om webbsidan i webbläsaren för att se det nya temat.

Detta var en snabb liten introduktion till Pelican. Allt detta gjordes på en lokal maskin. Om du vill att andra ska se din webbplats måste du ladda upp de förgenererade HTML-filerna till en server. Om du tittar i detalj på utgången av pelikan-snabbstartser du alternativ för att använda FTP, SSH, S3 och till och med GitHub -sidorna.

Det kan få mer information om denna generator i projektwebbplats eller i din GitHub-förvar.


Lämna din kommentar

Din e-postadress kommer inte att publiceras. Obligatoriska fält är markerade med *

*

*

  1. Ansvarig för uppgifterna: Miguel Ángel Gatón
  2. Syftet med uppgifterna: Kontrollera skräppost, kommentarhantering.
  3. Legitimering: Ditt samtycke
  4. Kommunikation av uppgifterna: Uppgifterna kommer inte att kommuniceras till tredje part förutom enligt laglig skyldighet.
  5. Datalagring: databas värd för Occentus Networks (EU)
  6. Rättigheter: När som helst kan du begränsa, återställa och radera din information.