Pelican, μια γεννήτρια στατικών τοποθεσιών με βάση την Python

για τον Πελεκάνο

Στο επόμενο άρθρο θα ρίξουμε μια ματιά στον Πελεκάνο. Αυτή είναι μια καλή επιλογή για χρήστες Python που θέλουν να φιλοξενήσουν μόνοι τους έναν απλό ιστότοπο ή ιστολόγιο. Εάν ενδιαφέρεστε να δημιουργήσετε έναν προσαρμοσμένο ιστότοπο ή ιστολόγιο, έχετε πολλές διαθέσιμες επιλογές σήμερα. Αλλά αν μόνο θέλετε να προβάλλετε στατικές ιστοσελίδες, αυτό το εργαλείο δημιουργίας στατικών ιστότοπων μπορεί να είναι χρήσιμο για εσάςΤο Αυτοί οι τύποι εφαρμογών χρησιμοποιούν πρότυπα για τη δημιουργία όλων των στατικών σελίδων που θέλει ο χρήστης και τη σύνδεσή τους με τα σχετικά μεταδεδομένα.

Εάν χρησιμοποιείτε Python και ψάχνετε κάτι για να δημιουργήσετε στατικές σελίδες HTML, αυτή η γεννήτρια θα σας επιτρέψει να ρίξετε μια ματιά στα εσωτερικά για το πώς λειτουργεί. Η χρήση μιας γλώσσας που γνωρίζετε το διευκολύνει. Εάν δεν σας αρέσει η Python, υπάρχουν άλλες γεννήτριες στατικών ιστότοπων που χρησιμοποιούν άλλες γλώσσες.

Το Pelican είναι μια κοινώς χρησιμοποιούμενη γεννήτρια στατικών τοποθεσιών γραμμένη σε Python. Ανατολή υποστηρίζει άμεσα restructuredText και μπορεί να υποστηρίξει το Markdown, όταν είναι εγκατεστημένο το απαιτούμενο πακέτο. Όλες οι εργασίες εκτελούνται μέσω εργαλείων διεπαφής γραμμής εντολών (CLI), πράγμα που το καθιστά απλό για όποιον το γνωρίζει. Επιπλέον, το απλό εργαλείο γρήγορης εκκίνησης καθιστά τη δημιουργία ενός ιστότοπου εξαιρετικά εύκολη.

Εγκατάσταση Pelican και βασική διαμόρφωση

Δοκιμάζω αυτό το πρόγραμμα στο Ubuntu 20.04. Το πρώτο βήμα που θα ακολουθήσει θα είναι δημιουργήστε ένα virtualenv και εγκαταστήστε το PelicanΤο Αυτό μπορεί να γίνει ανοίγοντας ένα τερματικό (Ctrl + Alt + T) και χρησιμοποιώντας τις εντολές σε αυτό:

δημιουργία εικονικού περιβάλλοντος

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Μετά την ενημέρωση του pip, μπορούμε τώρα εγκαταστήστε το Pelican:

Εγκατάσταση Πελεκάνος

./venv/bin/pip install pelican

Εκτελέστε την εντολή pelican-quickstart

Μόλις εγκατασταθεί, το Pelican Quick Start CLI Tool θα δημιουργήσει τη βασική διάταξη και μερικά αρχεία για να ξεκινήσουμε.

Για να είμαι απλός, κατά την εκκίνηση της γρήγορης εκκίνησης χρησιμοποίησα τις τιμές για τον τίτλο και τον συγγραφέα και απάντησα N στο πρόθεμα url και σελιδοποίηση του άρθρου. Για τις υπόλοιπες ερωτήσεις, χρησιμοποίησα την προεπιλογήΤο Είναι πολύ εύκολο να αλλάξετε αυτές τις ρυθμίσεις στο αρχείο διαμόρφωσης αργότερα. Μπορεί να εκτελεστεί γρήγορη εκκίνηση με την εντολή:

πελεκάνη γρήγορης εκκίνησης

./venv/bin/pelican-quickstart

Όταν τελειώσει, μπορούμε να αλλάξουμε ορισμένες πτυχές των ρυθμίσεων. Απλώς πρέπει ανοίξτε το αρχείο pelicanconf.py στον αγαπημένο μας επεξεργαστή κειμένου.

αρχείο διαμόρφωσης

Στο εσωτερικό μπορούμε να αναζητήσουμε τη γραμμή:

TIMEZONE = 'Europe/Paris'

Και μπορούμε μεταβείτε στη ζώνη ώρας της χώρας που σας ενδιαφέρει.

να ενημέρωση ρυθμίσεων κοινωνικού συνδέσμου, πρέπει να αναζητήσετε τη μεταβλητή ΚΟΙΝΩΝΙΚΗ en pelicanconf.pyΤο Σε αυτό μπορούμε να προσθέσουμε τους συνδέσμους μας ως εξής:

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

Θα πρέπει να σημειώσετε ότι το κόμμα στο τέλος είναι σημαντικό. Αυτό το κόμμα βοηθά την Python να αναγνωρίσει ότι η μεταβλητή είναι στην πραγματικότητα ένα σύνολο. Βεβαιωθείτε ότι δεν το διαγράφετε.

Ξεκινήστε τον διακομιστή

Τώρα που έχουμε τα βασικά ενός ιστότοπου, μπορούμε να δούμε ότι η γρήγορη εκκίνηση δημιούργησε ένα Makefile με διάφορους σκοπούς. Ένα από αυτά κάνει Ο devserver μπορεί να ξεκινήσει έναν διακομιστή ανάπτυξης στο μηχάνημά μας έτσι ώστε να μπορούμε να κάνουμε προεπισκόπηση ό, τι δημιουργούμε. Οι εντολές CLI που χρησιμοποιούνται στο Makefile υποτίθεται ότι αποτελούν μέρος του PATH μας, οπότε πρώτα πρέπει να ενεργοποιήσουμε το virtualenv.

διακομιστή εκκίνησης

source ./venv/bin/activate

make devserver

Όταν ξεκινήσει, μπορούμε ανοίξτε το πρόγραμμα περιήγησής μας και μεταβείτε στη διεύθυνση URL http://localhost:8000 για να δείτε το ιστολόγιο που έχει δημιουργηθεί.

δείγμα σελίδας που δημιουργήθηκε με τον Πελεκάνο

Προσθέστε περιεχόμενο

Τώρα που έχουμε έναν βασικό ιστότοπο, μπορούμε να προσθέσουμε κάποιο περιεχόμενο. Πρώτα, θα δημιουργήσουμε ένα αρχείο με το όνομα καλώς ήρθατε στον κατάλογο περιεχομένου (περιεχόμενο) του ιστότοπου.

Με τον αγαπημένο μας επεξεργαστή κειμένου, θα δημιουργήσουμε αυτό το αρχείο με ένα κείμενο που ακολουθεί την ακόλουθη δομή:

προσθέστε περιεχόμενο σε πελεκάνο

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

Αφού γράψω το αρχείο, ο devserver πρέπει να ενημερώσει και να δημιουργήσει κάτι τέτοιο:

προστέθηκε το αρχείο καλωσορίσματος

Φορτώστε ξανά τον ιστότοπό σας στο πρόγραμμα περιήγησης για να δείτε τις αλλαγές.

στατική σελίδα καλωσορίσματος

Τα μεταδεδομένα προστέθηκαν αυτόματα στη σελίδα. Επί πλέον, Ο Πελεκάνος εντόπισε αυτόματα την κατηγορία εισαγωγής και πρόσθεσε την ενότητα στην επάνω πλοήγηση.

Τοπική αλλαγή

Εκτός από όλα τα παραπάνω, μπορούμε εύκολα να αλλάξουμε θέμα. Στο αποθετήριο Πελεκάνος-θέματα, μπορείτε να βρείτε διαφορετικά θέματα που έχουν δημιουργήσει οι χρήστεςΤο Είναι πολύ εύκολο να δοκιμάσετε νέα θέματα, απλά πρέπει να τα κατεβάσετε από το αποθετήριο, αποθηκεύστε τα στον υπολογιστή μας και στο αρχείο pelicanconf.py προσθέστε την ακόλουθη γραμμή με τη διαδρομή στο θέμα:

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

Ο διακομιστής devserver θα αναγεννήσει την παραγωγή του. Φορτώστε ξανά την ιστοσελίδα στο πρόγραμμα περιήγησης για να δείτε το νέο θέμα.

Αυτή ήταν μια γρήγορη μικρή εισαγωγή στον Πελεκάνο. Όλα αυτά έγιναν σε τοπικό μηχάνημα. Εάν θέλετε οι άλλοι να βλέπουν τον ιστότοπό σας, θα πρέπει να ανεβάσετε τα προκαθορισμένα αρχεία HTML σε διακομιστήΤο Αν κοιτάξετε λεπτομερώς την έξοδο του πελεκάνος-γρήγορη εκκίνηση, θα δείτε επιλογές για χρήση FTP, SSH, S3, ακόμη και των σελίδων GitHub.

μπορεί λάβετε περισσότερες πληροφορίες σχετικά με αυτήν τη γεννήτρια στο ιστοσελίδα του έργου ή στο δικό σας Αποθήκη GitHub.


Αφήστε το σχόλιό σας

Η διεύθυνση email σας δεν θα δημοσιευθεί. Τα υποχρεωτικά πεδία σημειώνονται με *

*

*

  1. Υπεύθυνος για τα δεδομένα: Miguel Ángel Gatón
  2. Σκοπός των δεδομένων: Έλεγχος SPAM, διαχείριση σχολίων.
  3. Νομιμοποίηση: Η συγκατάθεσή σας
  4. Κοινοποίηση των δεδομένων: Τα δεδομένα δεν θα κοινοποιούνται σε τρίτους, εκτός από νομική υποχρέωση.
  5. Αποθήκευση δεδομένων: Βάση δεδομένων που φιλοξενείται από τα δίκτυα Occentus (ΕΕ)
  6. Δικαιώματα: Ανά πάσα στιγμή μπορείτε να περιορίσετε, να ανακτήσετε και να διαγράψετε τις πληροφορίες σας.