Pelican, un generatore di siti statici basato su Python

su Pelican

Nel prossimo articolo daremo un'occhiata a Pelican. Questa è una buona opzione per gli utenti Python che desiderano ospitare autonomamente un semplice sito Web o blog. Se sei interessato a creare un sito Web o un blog personalizzato, hai molte opzioni disponibili oggi. Ma se solo vuoi servire pagine web statiche, questo costruttore di siti statici potrebbe esserti utile. Questi tipi di applicazioni utilizzano modelli per creare tutte le pagine statiche desiderate dall'utente e collegarle ai metadati associati.

Se usi Python e stai cercando qualcosa per generare pagine HTML statiche, questo generatore ti consentirà di dare un'occhiata all'interno di come funziona. Usare una lingua che conosci lo rende più facile. Se non ti piace Python, ci sono altri generatori di siti statici che usano altri linguaggi.

Pelican è un generatore di siti statici comunemente usato scritto in Python. est supporta direttamente testoristrutturato e può supportare Markdown, quando il pacchetto richiesto è installato. Tutte le attività vengono eseguite tramite strumenti dell'interfaccia a riga di comando (CLI), il che lo rende semplice per chiunque lo conosca. Inoltre, il suo semplice strumento di avvio rapido rende estremamente facile la creazione di un sito web.

Installazione di Pelican e configurazione di base

Sto testando questo programma su Ubuntu 20.04. Il primo passo da seguire sarà creare a virtualenv e installa Pelican. Questo può essere fatto aprendo un terminale (Ctrl + Alt + T) e usando i comandi al suo interno:

creazione dell'ambiente virtuale

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Dopo aver aggiornato pip, ora possiamo installa Pelican:

struttura pellicano

./venv/bin/pip install pelican

Esegui il comando pellican-quickstart

Una volta installato, lo strumento CLI Pelican Quick Start creerà il layout di base e alcuni file in modo da poter iniziare.

Per semplificare le cose, durante l'esecuzione dell'avvio rapido ho utilizzato i valori per il titolo e l'autore e ho risposto N al prefisso dell'URL e all'impaginazione dell'articolo. Per il resto delle domande, ho usato l'impostazione predefinita. È molto facile modificare queste impostazioni nel file di configurazione in un secondo momento. È possibile eseguire l'avvio rapido con il comando:

pellicano di avvio rapido

./venv/bin/pelican-quickstart

Al termine, possiamo modificare alcuni aspetti delle impostazioni. Non ci resta che apri il file pelicanconf.py nel nostro editor di testo preferito.

file di configurazione

All'interno possiamo cercare la linea:

TIMEZONE = 'Europe/Paris'

E possiamo passa al fuso orario del paese che ti interessa.

a aggiorna le impostazioni del collegamento social, devi cercare la variabile SOCIAL en pellicanconf.py. In esso possiamo aggiungere i nostri collegamenti come segue:

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

Dovresti notare che la virgola alla fine è importante. Quella virgola aiuta Python a riconoscere che la variabile è in realtà un insieme. Assicurati di non eliminarlo.

Avvia il server

Ora che abbiamo le basi di un sito, possiamo vedere che l'avvio rapido ha creato un Makefile con vari scopi. Uno di loro fa devserver può avviare un server di sviluppo sulla nostra macchina in modo da poter visualizzare in anteprima tutto ciò che stiamo creando. I comandi CLI usati nel Makefile dovrebbero far parte del nostro PATH, quindi prima dobbiamo attivare virtualenv.

avvia il server

source ./venv/bin/activate

make devserver

Quando inizia, possiamo apri il nostro browser e vai all'URL http://localhost:8000 per vedere il blog che è stato creato.

pagina di esempio creata con Pelican

Aggiungi contenuto

Ora che abbiamo un sito di base, possiamo aggiungere alcuni contenuti. Primo, creeremo un file chiamato benvenuto.prima nella directory dei contenuti (contenuto) del sito.

Con il nostro editor di testo preferito, creeremo questo file con un testo che segue la seguente struttura:

aggiungi contenuto in pellicano

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

Dopo aver scritto il file, il server di sviluppo dovrebbe aggiornarsi e generare qualcosa del genere:

file di benvenuto aggiunto

Ricarica il tuo sito di prova nel browser per vedere le modifiche.

pagina di benvenuto statica

I metadati sono stati aggiunti automaticamente alla pagina. Cosa c'è di più, Pelican ha rilevato automaticamente la categoria Intro e ha aggiunto la sezione alla navigazione in alto.

Cambiare argomento

Oltre a tutto quanto sopra, possiamo facilmente cambiare argomento. Nel repository Temi-pellicano, puoi trovare diversi temi creati dagli utenti. È molto facile testare nuovi temi, devi solo scaricarli dal repository, salvali sul nostro computer e nel file pelicanconf.py aggiungi la seguente riga con il percorso del tema:

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

Il server di sviluppo rigenererà il suo output. Ricarica la pagina web nel browser per vedere il nuovo tema.

Questa è stata una breve introduzione a Pelican. Tutto questo è stato fatto su una macchina locale. Se vuoi che altri vedano il tuo sito, dovrai caricare i file HTML pregenerati su un server. Se osservi in ​​dettaglio l'output di pellicano-quickstart, vedrai le opzioni per utilizzare FTP, SSH, S3 e persino le pagine GitHub.

Si può ottenere maggiori informazioni su questo generatore nel sito web del progetto o in Repository GitHub.


Lascia un tuo commento

L'indirizzo email non verrà pubblicato. I campi obbligatori sono contrassegnati con *

*

*

  1. Responsabile dei dati: Miguel Ángel Gatón
  2. Scopo dei dati: controllo SPAM, gestione commenti.
  3. Legittimazione: il tuo consenso
  4. Comunicazione dei dati: I dati non saranno oggetto di comunicazione a terzi se non per obbligo di legge.
  5. Archiviazione dati: database ospitato da Occentus Networks (UE)
  6. Diritti: in qualsiasi momento puoi limitare, recuperare ed eliminare le tue informazioni.