V nasledujúcom článku sa pozrieme na Pelikána. Je to dobrá voľba pre používateľov Pythonu, ktorí chcú vlastniť jednoduchý web alebo blog. Ak máte záujem vytvoriť si vlastnú webovú stránku alebo blog, dnes máte k dispozícii mnoho možností. Ale keby len ak chcete zobrazovať statické webové stránky, môže byť pre vás tento nástroj na tvorbu statických stránok užitočný. Tieto typy aplikácií používajú šablóny na vytváranie všetkých statických stránok, ktoré chce používateľ, a na ich prepojenie s priradenými metadátami.
Ak používate Pytón a hľadáte niečo na generovanie statických stránok HTMLTento generátor vám umožní pozrieť sa na vnútornosti toho, ako funguje. Používanie jazyka, ktorý poznáte, to uľahčuje. Ak sa vám Python nepáči, existujú ďalšie generátory statických stránok, ktoré používajú iné jazyky.
Pelican je bežne používaný generátor statických stránok napísaný v Pythone. Východ priamo podporuje reStructuredText a môže podporovať Markdown, keď je nainštalovaný požadovaný balík. Všetky úlohy sa vykonávajú pomocou nástrojov rozhrania príkazového riadka (CLI), čo je jednoduché pre každého, kto ho pozná. Navyše, jeho jednoduchý nástroj pre rýchly štart veľmi uľahčuje vytváranie webových stránok.
Inštalácia a základná konfigurácia Pelican
Testujem tento program na Ubuntu 20.04. Prvým krokom, ktorý bude nasledovať, bude vytvoriť VIRTUALENV a nainštalujte Pelican. To sa dá urobiť otvorením terminálu (Ctrl + Alt + T) a použitím príkazov v ňom:
mkdir test-sitio cd test-sitio python3.8 -m venv venv ./venv/bin/pip install --upgrade pip
Po aktualizácii pipu môžeme teraz nainštalovať Pelican:
./venv/bin/pip install pelican
Spustite príkaz pelican-quickstart
Po inštalácii základné rozloženie vytvorí nástroj Pelican Quick Start CLI a niektoré súbory, aby sme mohli začať.
Aby to nebolo jednoduché, pri spustení rýchleho štartu som použil hodnoty pre názov a autora a odpovedal som N na predponu adresy URL a stránkovanie článku. Pokiaľ ide o ostatné otázky, použil som predvolené. Je veľmi jednoduché zmeniť tieto nastavenia v konfiguračnom súbore neskôr. Je možné spustiť rýchly štart príkazom:
./venv/bin/pelican-quickstart
Keď je to hotové, môžeme zmeniť niektoré aspekty nastavení. Proste musíme otvorte súbor pelicanconf.py v našom obľúbenom textovom editore.
Vnútri môžeme hľadať riadok:
TIMEZONE = 'Europe/Paris'
A môžeme zmeňte na časové pásmo krajiny, ktorá vás zaujíma.
na aktualizujte nastavenia sociálnych odkazov, musíte hľadať premennú SOCIÁLNE en pelicanconf.py. V ňom môžeme pridať naše odkazy nasledovne:
SOCIAL = (('Twitter (#Ubunlog)', 'https://twitter.com/UbunlogWeb'),)
Všimnite si toho, že čiarka na konci je dôležitá. Táto čiarka pomáha Pythonu rozpoznať, že premenná je vlastne množina. Uistite sa, že ho neodstránite.
Spustite server
Teraz, keď máme základy stránok, vidíme, že rýchly štart vytvoril Makefile na rôzne účely. Jeden z nich robí devserver môže na našom počítači spustiť vývojový server aby sme si mohli prezrieť všetko, čo vytvárame. Príkazy CLI použité v Makefile majú byť súčasťou našej PATH, takže najskôr musíme aktivovať virtualenv.
source ./venv/bin/activate make devserver
Keď to začne, môžeme otvorte náš prehliadač a prejdite na adresu URL http://localhost:8000 zobraziť blog, ktorý bol vytvorený.
Pridajte obsah
Teraz, keď máme základnú stránku, môžeme pridať nejaký obsah. Najprv, vytvoríme súbor s názvom vitajte v adresári obsahu (obsah) stránky.
Pomocou nášho obľúbeného textového editora vytvoríme tento súbor s textom, ktorý sleduje nasledujúcu štruktúru:
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.).
Po napísaní súboru devserver by mal aktualizovať a vygenerovať niečo také:
Znova načítajte svoj testovací web v prehliadači vidieť zmeny.
Metadáta boli automaticky pridané na stránku. Čo je viac, Pelican automaticky rozpoznal kategóriu Úvod a pridal sekciu do hornej navigácie.
Zmeňte tému
Okrem všetkého vyššie uvedeného môžeme ľahko zmeniť tému. V úložisku Pelikánske motívy, môžete nájsť rôzne témy, ktoré používatelia vytvorili. Testovanie nových tém je veľmi jednoduché, stačí si ich stiahnuť z úložiska, uložte ich na náš počítač a do súboru pelicanconf.py pridajte nasledujúci riadok s cestou k téme:
THEME = "/home/tu-usuario/pelican-tema/nombre-del-tema"
Devserver regeneruje svoj výstup. Znovu načítajte webovú stránku v prehliadači, aby sa zobrazila nová téma.
Toto bol rýchly malý úvod do Pelikána. To všetko sa robilo na miestnom počítači. Ak chcete, aby sa na vašu stránku pozerali ostatní, budete musieť nahrať vopred vygenerované súbory HTML na server. Ak sa podrobne pozriete na výstup z pelikán-rýchly štart, uvidíte možnosti použitia stránok FTP, SSH, S3 a dokonca aj GitHub.
To môže získať viac informácií o tomto generátore v webová stránka projektu alebo vo vašom Úložisko GitHub.