Pelican, en Python-basert statisk stedgenerator

om Pelican

I den neste artikkelen skal vi ta en titt på Pelican. Dette er et godt alternativ for Python-brukere som ønsker å være vert for et enkelt nettsted eller en blogg. Hvis du er interessert i å lage et tilpasset nettsted eller blogg, har du mange alternativer tilgjengelig i dag. Men hvis bare Hvis du vil vise statiske nettsider, kan denne statiske nettstedbyggeren være nyttig for deg. Denne typen applikasjoner bruker maler til å lage alle de statiske sidene brukeren ønsker, og koble dem til de tilhørende metadataene.

Hvis du bruker Python og du leter etter noe for å generere statiske HTML -sider, vil denne generatoren tillate deg å se på det indre av hvordan det fungerer. Det er lettere å bruke et språk du kjenner. Hvis du ikke liker Python, er det andre statiske nettstedgeneratorer som bruker andre språk.

Pelican er en vanlig statisk nettstedgenerator skrevet i Python. Øst støtter direkte reStructuredText og kan støtte Markdown, når den nødvendige pakken er installert. Alle oppgaver utføres gjennom kommandolinjegrensesnittverktøy (CLI), noe som gjør det enkelt for alle som er kjent med det. Pluss det enkle hurtigstartverktøyet gjør det ekstremt enkelt å lage et nettsted.

Pelikaninstallasjon og grunnleggende konfigurasjon

Jeg tester dette programmet på Ubuntu 20.04. Det første trinnet å følge vil være opprette en virtualenv og installer Pelican. Dette kan gjøres ved å åpne en terminal (Ctrl + Alt + T) og bruke kommandoene i den:

opprettelse av det virtuelle miljøet

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Etter oppdatering av pip kan vi nå installere Pelican:

Pelikananlegg

./venv/bin/pip install pelican

Kjør kommandoen pelican-quickstart

Når den er installert, Pelican Quick Start CLI Tool vil lage det grunnleggende oppsettet og noen filer slik at vi kan komme i gang.

For å holde ting enkelt, brukte jeg verdiene for tittelen og forfatteren og svarte når jeg kjørte hurtigstarten N til url -prefikset og paginering av artikkelen. For resten av spørsmålene, jeg brukte standard. Det er veldig enkelt å endre disse innstillingene i konfigurasjonsfilen senere. Hurtigstart kan kjøres med kommandoen:

hurtigstart pelikan

./venv/bin/pelican-quickstart

Når det er gjort, kan vi endre visse aspekter av innstillingene. Vi må bare åpne filen pelicanconf.py i vår favoritt tekstredigerer.

konfigurasjonsfil

Innvendig kan vi se etter linjen:

TIMEZONE = 'Europe/Paris'

Og vi kan endre til tidssonen i landet som interesserer deg.

Til oppdatere innstillinger for sosiale lenker, må du se etter variabelen SOSIAL en pelicanconf.py. I den kan vi legge til våre lenker som følger:

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

Du bør merke at kommaet på slutten er viktig. Dette kommaet hjelper Python med å gjenkjenne at variabelen faktisk er et sett. Pass på at du ikke sletter det.

Start serveren

Nå som vi har det grunnleggende om et nettsted, kan vi se at hurtigstarten opprettet en Makefile med forskjellige formål. En av dem lager devserver kan starte en utviklingsserver på maskinen vår slik at vi kan forhåndsvise alt vi lager. CLI -kommandoene som brukes i Makefile skal være en del av vår PATH, så først vi må aktivere virtualenv.

start server

source ./venv/bin/activate

make devserver

Når det starter, kan vi åpne nettleseren vår og gå til nettadressen http://localhost:8000 for å se bloggen som er opprettet.

eksempelside laget med Pelican

Legg til innhold

Nå som vi har et grunnleggende nettsted, kan vi legge til litt innhold. Først, vi oppretter en fil som heter velkommen.først i innholdskatalogen (innhold) på nettstedet.

Med vår favoritt tekstredigerer, vi vil lage denne filen med en tekst som følger følgende struktur:

legge til innhold 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.).

Etter å ha skrevet filen, devserver bør oppdatere og generere noe slikt:

velkomstfil lagt til

Last inn teststedet på nytt i nettleseren for å se endringene.

statisk velkomstside

Metadataene ble automatisk lagt til på siden. Hva mer, Pelican oppdaget Intro -kategorien automatisk og la delen til den øverste navigasjonen.

Endre tema

I tillegg til alt det ovennevnte, kan vi enkelt endre emne. I depotet Pelikan-temaer, kan du finne forskjellige temaer som brukerne har opprettet. Det er veldig enkelt å teste nye temaer, du må bare laste dem ned fra depotet, lagre dem på datamaskinen vår og i filen pelicanconf.py legg til følgende linje med banen til temaet:

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

Devserveren vil regenerere utgangen. Last nettsiden på nytt i nettleseren for å se det nye temaet.

Dette var en rask liten introduksjon til Pelican. Alt dette ble gjort på en lokal maskin. Hvis du vil at andre skal se nettstedet ditt, må du laste opp forhåndsgenererte HTML-filer til en server. Hvis du ser detaljert på utgangen av pelikan-hurtigstart, ser du alternativer for å bruke FTP, SSH, S3 og til og med GitHub -sidene.

Det kan få mer informasjon om denne generatoren i prosjektnettsted eller i din GitHub-depot.


Legg igjen kommentaren

Din e-postadresse vil ikke bli publisert. Obligatoriske felt er merket med *

*

*

  1. Ansvarlig for dataene: Miguel Ángel Gatón
  2. Formålet med dataene: Kontroller SPAM, kommentaradministrasjon.
  3. Legitimering: Ditt samtykke
  4. Kommunikasjon av dataene: Dataene vil ikke bli kommunisert til tredjeparter bortsett fra ved juridisk forpliktelse.
  5. Datalagring: Database vert for Occentus Networks (EU)
  6. Rettigheter: Når som helst kan du begrense, gjenopprette og slette informasjonen din.