Pelican pozwala w łatwy sposób wygerować i prowadzić niewielki serwis WWW na bazie prostych plików tekstowych, nie wymaga do tego baz danych ani zawwansownego serwera.
Główne cechy
- pozwala tworzyć treści w formatach reStructuredText i Markdown
- jest rozwijany w Pythonie
- korzysta ze sprawdzonego silnika templejtów Jinja2
- posiada spore biblioteki szablonów oraz wtyczek
Wybór
Dlaczego pelican moze być dobrym wyborem na system obsługi witryny ?
W porównaiu do takich kombajnów jak Wordpress jest stosunkowo prosty i wymaga mniej zasobów komputera. Pracuje na plikach tekstowych ze znacznikami, co dla jednych będzie zaletą, bo pliki są małe i przejrzyste pozwalajć skupić się na treści formatowanie i ostylowanie zostawiając systemowi szablonów, ale dla osobów przyzwyczajonych do WYSWIG może być to wyzwaniem. Oczywiście w takiej sytuacji można też użyć edytora Markdown który wspiera wizualizację tekstu ze znacznikami.
Instalacja
W Debianie i pochodnych można go zainstalować z repozytorium pakietów dystrybucji:
apt install pelican
Jeśli komuś zależy na najnowszej wersji pakiet można zainstalować z repozytoriów pypi za pomocą komedy
pip install pelican[Markdown]
Aby zacząć pracę używamy polecenia pelican-quickstart. Program wypyta nas o
podstawowe dane dotyczące naszej witryny takie jak tytuł, język, adres i
wygeneruje pliki konfiguracyjne i katalogi na treść.
[screenshot pelican-quickstart ]
Możemy teraz zacząć dodawać treść.
W katalogu content za pomocą edytora tekstowego np. joe tworzymy plik, powiedzmy rybka.md
joe content/rybka.md
i wstawiamy treść:
Title: Witaj rybko!
Date: 2019-10-20 09:20
Author: Adasko
### Plusk!
Pelikan łyka tę rybkę.
Aby wygenerować witrynę, wystarczy wydać polcenie
make html
w katalog w którym znajdują się pliki wygenerowanie przez
pelican-quickstart.
W katalogu output zostanie wytworzona witrynka.
Aby ją podejrzeć możemy nakierować przeglądarkę na pliki na dysku, ale
pelican ma tryb serwerowy, który pozwala podglądać tworzoną stronę.
Aby go włączyć dajemy polecenie:
make serve
Zostanie uruchmiony lokalny serwer pelicana, domyślnie na porcie 8000. Zatem podajemy w przeglądarce adres: http://localhost:8000 i już możemy oglądać nasz produkt.
Pelican oferuje też mechanizmy do publikacji strony na właściwych serwisach www.
Wersje i rozwój
Pelican jest dość dojrzałym projektem. Posiada repozytorium kodu na GitHubie wskazujące na istnienie projektu co najmniej już od 2010 roku. Tym nie mniej rozwój na GitHubie cały czas się toczy. W momencie aktualizacji tego artykułu dostępna jest wersja 4.11.0.

Linki:
- https://github.com/getpelican/pelican
- https://antonellocalamea.medium.com/step-by-step-guide-to-setup-a-web-site-using-pelican-and-gitpages-5de976ae44cb