Pelican, Python-alapú statikus webhelygenerátor

Pelikánról

A következő cikkben a Pelican -t vesszük szemügyre. Ez egy jó lehetőség azoknak a Python-felhasználóknak, akik egy egyszerű webhelyet vagy blogot akarnak önállóan üzemeltetni. Ha szeretne egyéni weboldalt vagy blogot létrehozni, ma számos lehetőség közül választhat. De ha csak ha statikus weboldalakat szeretne megjeleníteni, akkor ez a statikus webhely -készítő hasznos lehet az Ön számára. Az ilyen típusú alkalmazások sablonok segítségével hozzák létre a felhasználó által kívánt összes statikus oldalt, és összekapcsolják azokat a kapcsolódó metaadatokkal.

Ha használja Piton és statikus HTML oldalak létrehozásához keres valamitEz a generátor lehetővé teszi, hogy megnézze a működését. Az Ön által ismert nyelv használata megkönnyíti. Ha nem tetszik a Python, vannak más statikus webhelygenerátorok is, amelyek más nyelveket használnak.

A Pelican egy általánosan használt statikus webhelygenerátor, Python nyelven írva. Keleti közvetlenül támogatja reStructuredText és támogathatja a Markdown -ot, amikor a szükséges csomag telepítve van. Minden feladatot parancssori felületen keresztül hajtanak végre (CLI), ami egyszerűvé teszi mindenki számára, aki ismeri. Ezenkívül egyszerű gyorsindító eszköze rendkívül egyszerűvé teszi a webhely létrehozását.

Pelikán telepítés és alapvető konfiguráció

Ezt a programot az Ubuntu 20.04 -en teszteltem. A követendő első lépés az lesz hozzon létre egy virtualenv és telepítse a Pelikánt. Ezt úgy teheti meg, hogy megnyit egy terminált (Ctrl + Alt + T), és használja a benne található parancsokat:

virtuális környezet létrehozása

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

A pip frissítése után most megtehetjük telepítse a Pelican -t:

Pelikán létesítmény

./venv/bin/pip install pelican

Futtassa a pelican-quickstart parancsot

A telepítés után a Pelican Quick Start CLI Tool létrehozza az alapelrendezést és néhány fájlt, hogy elkezdhessük.

Az egyszerűség kedvéért a gyorsindítás futtatásakor a cím és a szerző értékeit használtam, és válaszoltam N a cikk url előtagjához és lapozásához. A többi kérdésre, az alapértelmezettet használtam. Ezeket a beállításokat később nagyon könnyű megváltoztatni a konfigurációs fájlban. A gyorsindítás futtatható a következő paranccsal:

gyorsindító pelikán

./venv/bin/pelican-quickstart

Ha elkészült, megváltoztathatjuk a beállítások bizonyos aspektusait. Csak muszáj nyissa meg a pelicanconf.py fájlt a kedvenc szövegszerkesztőnkben.

konfigurációs fájl

Odabent kereshetjük a sort:

TIMEZONE = 'Europe/Paris'

És megtehetjük váltson az Önt érdeklő ország időzónájára.

hogy frissítse a közösségi link beállításait, meg kell keresni a változót SZOCIÁLIS en pelicanconf.py. Ebben a linkeket a következőképpen adhatjuk hozzá:

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

Fontos megjegyezni, hogy a végén található vessző fontos. Ez a vessző segít a Pythonnak felismerni, hogy a változó valójában halmaz. Ügyeljen arra, hogy ne törölje.

Indítsa el a szervert

Most, hogy megvan az oldal alapjai, láthatjuk, hogy a gyorsindító létrehozott egy Makefile -t, különböző célokkal. Egyikük készít A devserver elindíthat egy fejlesztő szervert a gépünkön hogy előnézetben láthassunk mindent, amit készítünk. A Makefile -ban használt CLI parancsoknak állítólag a PATH részünknek kell lenniük, tehát először aktiválnunk kell a virtualenv -t.

indítsa el a szervert

source ./venv/bin/activate

make devserver

Amikor elkezdődik, megtehetjük nyissa meg böngészőnket, és lépjen az URL -re http://localhost:8000 hogy megtekinthesse a létrehozott blogot.

mintaoldal Pelikánnal létrehozva

Tartalom hozzáadása

Most, hogy van egy alap webhelyünk, hozzáadhatunk néhány tartalmat. Első, nevű fájlt hozunk létre üdvözlöm.els a tartalomkönyvtárban (tartalom) a webhelyről.

Kedvenc szövegszerkesztőnkkel ezt a fájlt az alábbi struktúrát követõ szöveggel hozzuk létre:

adjon hozzá tartalmat pelikánban

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

A fájl megírása után, a fejlesztőnek frissítenie kell és ilyesmit kell generálnia:

üdvözlő fájl hozzáadva

Töltse be újra a tesztoldalát a böngészőben a változások megtekintéséhez.

statikus üdvözlőoldal

A metaadatok automatikusan hozzáadódtak az oldalhoz. Mi több, Pelikán automatikusan észlelte az Intro kategóriát, és hozzáadta a szakaszt a felső navigációhoz.

Válts témát

A fentiek mellett könnyen válthatunk témát. Az adattárban Pelikán-témák, különböző témákat találhat, amelyeket a felhasználók hoztak létre. Nagyon könnyű tesztelni az új témákat, csak le kell tölteni őket a tárolóból, mentse el őket a számítógépünkre, és a pelicanconf.py fájlba írja be a következő sort a téma elérési útjával:

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

A fejlesztő regenerálja a kimenetét. Töltse be újra a weboldalt a böngészőben az új téma megtekintéséhez.

Ez egy rövid kis bevezető volt a Pelikánhoz. Mindez helyi gépen történt. Ha szeretné, hogy mások is lássák webhelyét, fel kell töltenie az előre generált HTML fájlokat egy szerverre. Ha részletesen megvizsgálja a kimenetét pelikán-gyorsindítás, látni fogja az FTP, SSH, S3 és még a GitHub oldalak használatának lehetőségeit.

Ez lehet további információkat talál erről a generátorról a projekt honlapja vagy a saját GitHub tárház.


Hagyja megjegyzését

E-mail címed nem kerül nyilvánosságra. Kötelező mezők vannak jelölve *

*

*

  1. Az adatokért felelős: Miguel Ángel Gatón
  2. Az adatok célja: A SPAM ellenőrzése, a megjegyzések kezelése.
  3. Legitimáció: Az Ön beleegyezése
  4. Az adatok közlése: Az adatokat csak jogi kötelezettség alapján továbbítjuk harmadik felekkel.
  5. Adattárolás: Az Occentus Networks (EU) által üzemeltetett adatbázis
  6. Jogok: Bármikor korlátozhatja, helyreállíthatja és törölheti adatait.