Pelican, generátor statických stránek založený na Pythonu

o Pelikánovi

V dalším článku se podíváme na Pelikána. To je dobrá volba pro uživatele Pythonu, kteří chtějí sami hostovat jednoduchý web nebo blog. Pokud máte zájem o vytvoření vlastního webu nebo blogu, máte dnes k dispozici mnoho možností. Ale kdyby jen Chcete -li zobrazovat statické webové stránky, může být pro vás tento nástroj pro tvorbu statických stránek užitečný. Tyto typy aplikací používají šablony k vytváření všech statických stránek, které chce uživatel, a jejich propojení s přidruženými metadaty.

Pokud používáte PYTHON a hledáte něco pro generování statických HTML stránekTento generátor vám umožní nahlédnout do vnitřních částí toho, jak funguje. Používání jazyka, který znáte, to usnadňuje. Pokud se vám Python nelíbí, existují další generátory statických webů, které používají jiné jazyky.

Pelican je běžně používaný generátor statických webů napsaný v Pythonu. Východní přímo podporuje reStructuredText a může podporovat Markdown, když je nainstalován požadovaný balíček. Všechny úkoly se provádějí prostřednictvím nástrojů rozhraní příkazového řádku (CLI), což usnadňuje každému, kdo se v tom vyzná. Navíc díky svému jednoduchému nástroji pro rychlé spuštění je vytváření webových stránek velmi snadné.

Instalace a základní konfigurace Pelican

Testuji tento program na Ubuntu 20.04. První krok, který bude následovat, bude vytvořit virtualenv a nainstalujte Pelican. To lze provést otevřením terminálu (Ctrl + Alt + T) a použitím příkazů v něm:

vytvoření virtuálního prostředí

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Po aktualizaci pipu můžeme nyní nainstalujte Pelican:

Zařízení Pelikán

./venv/bin/pip install pelican

Spusťte příkaz pelican-quickstart

Po instalaci základní rozvržení vytvoří nástroj Pelican Quick Start CLI a některé soubory, abychom mohli začít.

Aby to bylo jednoduché, při spuštění rychlého startu jsem použil hodnoty pro název a autora a odpověděl N na předponu URL a stránkování článku. U zbývajících otázek použil jsem výchozí. Je velmi snadné změnit tato nastavení v konfiguračním souboru později. Lze spustit rychlý start s příkazem:

rychlý start pelikán

./venv/bin/pelican-quickstart

Až to bude hotové, můžeme změnit určité aspekty nastavení. Prostě musíme otevřete soubor pelicanconf.py v našem oblíbeném textovém editoru.

konfigurační soubor

Uvnitř můžeme hledat řádek:

TIMEZONE = 'Europe/Paris'

A můžeme změnit časové pásmo země, která vás zajímá.

na aktualizovat nastavení sociálních odkazů, musíte hledat proměnnou SOCIÁLNÍ en pelicanconf.py. V něm můžeme přidat naše odkazy následujícím způsobem:

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

Měli byste si uvědomit, že čárka na konci je důležitá. Tato čárka pomáhá Pythonu rozpoznat, že proměnná je ve skutečnosti sada. Ujistěte se, že jej nesmažete.

Spusťte server

Nyní, když máme základy webu, vidíme, že rychlý start vytvořil Makefile s různými účely. Jeden z nich dělá devserver může na našem počítači spustit vývojový server abychom si mohli prohlédnout vše, co vytváříme. Příkazy CLI použité v Makefile mají být součástí naší PATH, takže nejprve musíme aktivovat virtualenv.

spustit server

source ./venv/bin/activate

make devserver

Když to začne, můžeme otevřete náš prohlížeč a přejděte na adresu URL http://localhost:8000 zobrazit blog, který byl vytvořen.

ukázková stránka vytvořená pomocí Pelican

Přidejte obsah

Nyní, když máme základní web, můžeme přidat nějaký obsah. Za prvé, vytvoříme soubor s názvem vítejte v adresáři obsahu (obsah) webu.

S naším oblíbeným textovým editorem vytvoříme tento soubor s textem, který sleduje následující strukturu:

přidat obsah v pelikánu

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 napsání souboru devserver by měl něco takového aktualizovat a vygenerovat:

přidán uvítací soubor

Znovu načtěte testovací web v prohlížeči zobrazit změny.

statická uvítací stránka

Metadata byla automaticky přidána na stránku. A co víc, Pelican automaticky detekoval kategorii Intro a přidal sekci do horní navigace.

Změnit téma

Kromě všeho výše uvedeného můžeme snadno změnit téma. V úložišti Pelikánská témata, můžete najít různá témata, která uživatelé vytvořili. Je velmi snadné testovat nová témata, stačí si je stáhnout z úložiště, uložte je na náš počítač a do souboru pelicanconf.py přidejte následující řádek s cestou k tématu:

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

Devserver bude regenerovat svůj výstup. Znovu načtěte webovou stránku v prohlížeči, abyste viděli nové téma.

To byl rychlý malý úvod do Pelikána. To vše bylo provedeno na místním počítači. Pokud chcete, aby váš web viděli ostatní, budete muset nahrát předem vygenerované soubory HTML na server. Pokud se podíváte podrobně na výstup z pelikán-rychlý start, zobrazí se možnosti použití stránek FTP, SSH, S3 a dokonce i GitHub.

To může získat více informací o tomto generátoru v webové stránky projektu nebo ve vašem Úložiště GitHub.


Zanechte svůj komentář

Vaše e-mailová adresa nebude zveřejněna. Povinné položky jsou označeny *

*

*

  1. Odpovědný za údaje: Miguel Ángel Gatón
  2. Účel údajů: Ovládací SPAM, správa komentářů.
  3. Legitimace: Váš souhlas
  4. Sdělování údajů: Údaje nebudou sděleny třetím osobám, s výjimkou zákonných povinností.
  5. Úložiště dat: Databáze hostovaná společností Occentus Networks (EU)
  6. Práva: Vaše údaje můžete kdykoli omezit, obnovit a odstranit.