Pelican, generator stron statycznych oparty na Pythonie

o Pelikanie

W następnym artykule przyjrzymy się Pelikanowi. Jest to dobra opcja dla użytkowników Pythona, którzy chcą samodzielnie hostować prostą stronę internetową lub blog. Jeśli jesteś zainteresowany stworzeniem własnej strony internetowej lub bloga, masz dziś do dyspozycji wiele opcji. Ale jeśli tylko chcesz obsługiwać statyczne strony internetowe, ten statyczny kreator witryn może być dla Ciebie przydatny. Tego typu aplikacje używają szablonów do tworzenia wszystkich stron statycznych, których potrzebuje użytkownik, i łączenia ich z powiązanymi metadanymi.

Jeśli używasz Python i szukasz czegoś do generowania statycznych stron HTML, ten generator pozwoli ci przyjrzeć się, jak to działa. Używanie języka, który znasz, ułatwia to. Jeśli nie lubisz Pythona, istnieją inne statyczne generatory witryn, które używają innych języków.

Pelican to powszechnie używany generator stron statycznych napisany w Pythonie. wschód bezpośrednio wspiera reStructuredText i może wspierać Markdown, po zainstalowaniu wymaganego pakietu. Wszystkie zadania są wykonywane za pomocą narzędzi interfejsu wiersza poleceń (CLI), co ułatwia każdemu, kto ją zna. Dodatkowo proste narzędzie szybkiego startu sprawia, że ​​tworzenie strony internetowej jest niezwykle łatwe.

Instalacja Pelican i konfiguracja podstawowa

Testuję ten program na Ubuntu 20.04. Pierwszym krokiem do naśladowania będzie utwórz virtualenv i zainstaluj Pelican. Można to zrobić, otwierając terminal (Ctrl + Alt + T) i używając zawartych w nim poleceń:

tworzenie środowiska wirtualnego

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Po aktualizacji pip możemy teraz zainstaluj Pelikana:

Placówka Pelikan

./venv/bin/pip install pelican

Uruchom polecenie pelican-quickstart

Po zainstalowaniu narzędzie Pelican Quick Start CLI utworzy podstawowy układ i trochę plików, abyśmy mogli zacząć.

Aby uprościć, podczas uruchamiania szybkiego startu użyłem wartości dla tytułu i autora i odpowiedziałem N do prefiksu adresu URL i paginacji artykułu. W przypadku pozostałych pytań użyłem domyślnego. Bardzo łatwo jest później zmienić te ustawienia w pliku konfiguracyjnym. Szybki start można uruchomić komendą:

pelikan szybkiego startu

./venv/bin/pelican-quickstart

Po zakończeniu możemy zmienić niektóre aspekty ustawień. Po prostu musimy otwórz plik pelicanconf.py w naszym ulubionym edytorze tekstu.

plik konfiguracyjny

Wewnątrz możemy poszukać linii:

TIMEZONE = 'Europe/Paris'

I możemy zmień strefę czasową kraju, który Cię interesuje.

do zaktualizuj ustawienia linków społecznościowych, musisz poszukać zmiennej SPOŁECZNEGO en pelicanconf.py. W nim możemy dodać nasze linki w następujący sposób:

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

Należy pamiętać, że przecinek na końcu jest ważny. Ten przecinek pomaga Pythonowi rozpoznać, że zmienna jest w rzeczywistości zestawem. Upewnij się, że go nie usuwasz.

Uruchom serwer

Teraz, gdy znamy już podstawy witryny, widzimy, że szybki start stworzył plik Makefile z różnymi celami. Jeden z nich sprawia, że devserver może uruchomić serwer programistyczny na naszej maszynie abyśmy mogli podejrzeć wszystko, co tworzymy. Polecenia CLI używane w Makefile mają być częścią naszej PATH, więc najpierw musimy aktywować virtualenv.

uruchom serwer

source ./venv/bin/activate

make devserver

Kiedy się zacznie, możemy otwórz naszą przeglądarkę i przejdź do adresu URL http://localhost:8000 aby zobaczyć utworzonego bloga.

przykładowa strona utworzona za pomocą Pelican

Dodaj zawartość

Teraz, gdy mamy już podstawową witrynę, możemy dodać trochę treści. Najpierw, utworzymy plik o nazwie witam.rst w katalogu zawartości (zawartość) witryny.

Z naszym ulubionym edytorem tekstu, utworzymy ten plik z tekstem o następującej strukturze:

dodaj zawartość w pelican

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 zapisaniu pliku programista powinien zaktualizować i wygenerować coś takiego:

dodano plik powitalny

Odśwież swoją witrynę testową w przeglądarce, aby zobaczyć zmiany.

statyczna strona powitalna

Metadane zostały automatycznie dodane do strony. Co więcej, Pelican automatycznie wykrył kategorię Intro i dodał sekcję do górnej nawigacji.

Zmień temat

Oprócz tego wszystkiego możemy łatwo zmienić temat. W repozytorium Pelikan-motywy, możesz znaleźć różne motywy utworzone przez użytkowników. Bardzo łatwo jest testować nowe motywy, wystarczy je pobrać z repozytorium, zapisz je na naszym komputerze i w pliku pelicanconf.py dodaj następującą linię ze ścieżką do motywu:

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

Programista zregeneruje swoje dane wyjściowe. Odśwież stronę internetową w przeglądarce, aby zobaczyć nowy motyw.

To było krótkie wprowadzenie do Pelikana. Wszystko to zostało zrobione na lokalnym komputerze. Jeśli chcesz, aby inni widzieli Twoją witrynę, musisz przesłać wstępnie wygenerowane pliki HTML na serwer. Jeśli przyjrzysz się szczegółowo wynikom pelikan-szybki start, zobaczysz opcje korzystania z FTP, SSH, S3, a nawet stron GitHub.

można uzyskaj więcej informacji o tym generatorze w witryna projektu lub w twoim Repozytorium GitHub.


Zostaw swój komentarz

Twój adres e-mail nie zostanie opublikowany. Wymagane pola są oznaczone *

*

*

  1. Odpowiedzialny za dane: Miguel Ángel Gatón
  2. Cel danych: kontrola spamu, zarządzanie komentarzami.
  3. Legitymacja: Twoja zgoda
  4. Przekazywanie danych: Dane nie będą przekazywane stronom trzecim, z wyjątkiem obowiązku prawnego.
  5. Przechowywanie danych: baza danych hostowana przez Occentus Networks (UE)
  6. Prawa: w dowolnym momencie możesz ograniczyć, odzyskać i usunąć swoje dane.