Pelican, en Python-baseret statisk stedgenerator

om Pelican

I den næste artikel vil vi tage et kig på Pelican. Dette er en god mulighed for Python-brugere, der ønsker at være vært for et simpelt websted eller en blog. Hvis du er interesseret i at oprette et tilpasset websted eller en blog, har du mange muligheder i dag. Men hvis bare du vil betjene statiske websider, kan denne statiske webstedsbygger være nyttig for dig. Disse typer applikationer bruger skabeloner til at oprette alle de statiske sider, som brugeren ønsker, og forbinde dem med de tilhørende metadata.

Hvis du bruger Python og du leder efter noget til at generere statiske HTML -sider, denne generator vil give dig mulighed for at tage et kig på det indre af, hvordan det fungerer. Det er lettere at bruge et sprog, du kender. Hvis du ikke kan lide Python, er der andre statiske webstedsgeneratorer, der bruger andre sprog.

Pelican er en almindeligt brugt statisk stedgenerator skrevet i Python. Øst understøtter direkte reStructuredText og kan understøtte Markdown, når den nødvendige pakke er installeret. Alle opgaver udføres via kommandolinjegrænseværktøjer (CLI), hvilket gør det enkelt for alle, der kender det. Plus dets enkle hurtigstartværktøj gør det ekstremt let at oprette et websted.

Pelikaninstallation og grundlæggende konfiguration

Jeg tester dette program på Ubuntu 20.04. Det første skridt at følge vil være opret en virtualenv og installer Pelican. Dette kan gøres ved at åbne en terminal (Ctrl + Alt + T) og bruge kommandoerne i den:

oprettelse af det virtuelle miljø

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Efter opdatering af pip kan vi nu installere Pelican:

Pelikananlæg

./venv/bin/pip install pelican

Kør kommandoen pelican-quickstart

Når den er installeret, Pelican Quick Start CLI Tool opretter det grundlæggende layout og nogle filer, så vi kan komme i gang.

For at holde tingene enkle, brugte jeg ved hurtig start værdierne for titlen og forfatteren og svarede N til url -præfikset og pagination af artiklen. For resten af ​​spørgsmålene, jeg brugte standard. Det er meget let at ændre disse indstillinger i konfigurationsfilen senere. Hurtig start kan køres med kommandoen:

hurtigstart pelikan

./venv/bin/pelican-quickstart

Når det er gjort, kan vi ændre visse aspekter af indstillingerne. Vi skal bare Åbn filen pelicanconf.py i vores foretrukne teksteditor.

konfigurationsfil

Inde kan vi kigge efter linjen:

TIMEZONE = 'Europe/Paris'

Og det kan vi skift til tidszonen i det land, der interesserer dig.

til opdatere indstillinger for sociale links, skal du kigge efter variablen SOCIAL en Pelicanconf.py. Heri kan vi tilføje vores links som følger:

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

Du skal bemærke, at kommaet i slutningen er vigtigt. Dette komma hjælper Python med at genkende, at variablen faktisk er et sæt. Sørg for, at du ikke sletter det.

Start serveren

Nu hvor vi har det grundlæggende på et websted, kan vi se, at hurtigstarten oprettede en Makefile med forskellige mål. En af dem laver devserver kan starte en udviklingsserver på vores maskine så vi kan få vist alt, hvad vi skaber. CLI -kommandoerne, der bruges i Makefile, formodes at være en del af vores PATH, så først vi skal aktivere virtualenv.

start server

source ./venv/bin/activate

make devserver

Når det starter, kan vi Åbn vores browser og gå til webadressen http://localhost:8000 for at se den blog, der er blevet oprettet.

eksempelside oprettet med Pelican

Tilføj indhold

Nu hvor vi har et grundlæggende websted, kan vi tilføje noget indhold. Først, vi opretter en fil, der hedder velkommen.rst i indholdsmappen (indhold) af webstedet.

Med vores yndlings teksteditor, vi opretter denne fil med en tekst, der følger den følgende struktur:

tilføj indhold 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 at have skrevet filen, devserveren skal opdatere og generere sådan noget:

velkomstfil tilføjet

Genindlæs dit testwebsted i browseren for at se ændringerne.

statisk velkomstside

Metadataene blev automatisk føjet til siden. Hvad mere er, Pelican registrerede automatisk Intro -kategorien og tilføjede afsnittet til den øverste navigation.

Skift emne

Ud over alt det ovenstående kan vi nemt ændre emne. I arkivet Pelikan-temaer, kan du finde forskellige temaer, som brugerne har oprettet. Det er meget let at teste nye temaer, du skal bare downloade dem fra depotet, gem dem på vores computer og i filen pelicanconf.py tilføj følgende linje med stien til temaet:

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

Devserveren genererer sit output. Genindlæs websiden i browseren for at se det nye tema.

Dette var en hurtig lille introduktion til Pelican. Alt dette blev udført på en lokal maskine. Hvis du vil have andre til at se dit websted, skal du uploade de forhåndsgenererede HTML-filer til en server. Hvis du ser detaljeret på output fra pelikan-hurtigstart, vil du se muligheder for at bruge FTP, SSH, S3 og endda GitHub -siderne.

Du kan få flere oplysninger om denne generator i projektwebsted eller i din GitHub-arkiv.


Efterlad din kommentar

Din e-mailadresse vil ikke blive offentliggjort. Obligatoriske felter er markeret med *

*

*

  1. Ansvarlig for dataene: Miguel Ángel Gatón
  2. Formålet med dataene: Control SPAM, management af kommentarer.
  3. Legitimering: Dit samtykke
  4. Kommunikation af dataene: Dataene vil ikke blive kommunikeret til tredjemand, undtagen ved juridisk forpligtelse.
  5. Datalagring: Database hostet af Occentus Networks (EU)
  6. Rettigheder: Du kan til enhver tid begrænse, gendanne og slette dine oplysninger.