Pelican, Python tabanlı bir statik site oluşturucu

Pelikan hakkında

Bir sonraki yazıda Pelikan'a bir göz atacağız. Bu, basit bir web sitesini veya blogu kendi kendine barındırmak isteyen Python kullanıcıları için iyi bir seçenektir. Özel bir web sitesi veya blog oluşturmakla ilgileniyorsanız, bugün birçok seçeneğiniz var. Ama eğer sadece statik web sayfaları sunmak istiyorsanız, bu statik site oluşturucu sizin için yararlı olabilir. Bu tür uygulamalar, kullanıcının istediği tüm statik sayfaları oluşturmak için şablonlar kullanır ve bunları ilişkili meta verilerle ilişkilendirir.

Kullanırsan Python ve statik HTML sayfaları oluşturmak için bir şey arıyorsunuz, bu jeneratör, nasıl çalıştığının iç kısımlarına bir göz atmanıza izin verecek. Bildiğiniz bir dili kullanmak işinizi kolaylaştırır. Python'dan hoşlanmıyorsanız, başka dilleri kullanan başka statik site oluşturucular da vardır.

Pelikan, Python ile yazılmış, yaygın olarak kullanılan bir statik site oluşturucudur. Doğu doğrudan destekler reStructuredText ve Markdown'ı destekleyebilir, gerekli paket yüklendiğinde. Tüm görevler komut satırı arabirim araçlarıyla gerçekleştirilir (CLI), bu da onu tanıyan herkes için basitleştirir. Ayrıca, basit hızlı başlangıç ​​aracı, bir web sitesi oluşturmayı son derece kolaylaştırır.

Pelikan Kurulumu ve Temel Yapılandırma

Bu programı Ubuntu 20.04'te test ediyorum. İzlenecek ilk adım, oluşturmak virtualenv ve Pelikan'ı yükleyin. Bu, bir terminal (Ctrl + Alt + T) açarak ve içindeki komutları kullanarak yapılabilir:

sanal ortamın oluşturulması

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Pip'i güncelledikten sonra, şimdi yapabiliriz Pelikan'ı kur:

Pelikan tesisi

./venv/bin/pip install pelican

pelikan-hızlı başlangıç ​​komutunu çalıştırın

Kurulduktan sonra, Pelican Quick Start CLI aracı temel düzeni oluşturacaktır ve bazı dosyalar, böylece başlayabiliriz.

İşleri basit tutmak için hızlı başlangıcı çalıştırırken başlık ve yazar için değerleri kullandım ve yanıtladım N makalenin url ön ekine ve sayfa numarasına. Geri kalan sorular için, varsayılanı kullandım. Bu ayarları daha sonra yapılandırma dosyasında değiştirmek çok kolaydır. Hızlı başlangıç ​​çalıştırılabilir komut ile:

hızlı başlangıç ​​pelikan

./venv/bin/pelican-quickstart

Tamamlandığında, ayarların belirli yönlerini değiştirebiliriz. sadece yapmalıyız pelicanconf.py dosyasını favori metin düzenleyicimizde açın.

yapılandırma dosyası

İçeride şu satırı arayabiliriz:

TIMEZONE = 'Europe/Paris'

Ve biz yapabiliriz sizi ilgilendiren ülkenin saat dilimini değiştirin.

Daha sosyal bağlantı ayarlarını güncelle, değişkeni aramak zorundasın SOSYAL en pelikanconf.py. İçinde bağlantılarımızı aşağıdaki gibi ekleyebiliriz:

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

Sondaki virgülün önemli olduğunu unutmamalısınız. Bu virgül Python'un değişkenin aslında bir küme olduğunu anlamasına yardımcı olur. Silmediğinizden emin olun.

Sunucuyu başlatın

Artık bir sitenin temellerine sahip olduğumuza göre, hızlı başlangıcın çeşitli amaçlarla bir Makefile oluşturduğunu görebiliriz. Bunlardan biri yapar devserver, makinemizde bir geliştirme sunucusu başlatabilir böylece yarattığımız her şeyi önizleyebiliriz. Makefile'de kullanılan CLI komutlarının PATH'imizin bir parçası olması gerekiyordu, bu yüzden önce virtualenv'i etkinleştirmeliyiz.

sunucuyu başlat

source ./venv/bin/activate

make devserver

Başladığında, yapabiliriz tarayıcımızı açın ve URL'ye gidin http://localhost:8000 oluşturulan blogu görmek için

Pelican ile oluşturulan örnek sayfa

İçerik ekle

Artık basit bir sitemiz olduğuna göre, biraz içerik ekleyebiliriz. Öncelikle, adlı bir dosya oluşturacağız hoşgeldiniz.rst içerik dizininde (içerik) Sitenin.

Favori metin düzenleyicimiz ile, bu dosyayı aşağıdaki yapıyı takip eden bir metinle oluşturacağız:

pelikan içerik ekle

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

Dosyayı yazdıktan sonra, geliştirici böyle bir şeyi güncellemeli ve üretmelidir:

hoş geldiniz dosyası eklendi

Test sitenizi yeniden yükleyin değişiklikleri görmek için tarayıcıda

statik karşılama sayfası

Meta veriler otomatik olarak sayfaya eklendi. Daha ne, Pelikan, Giriş kategorisini otomatik olarak algıladı ve bölümü en üstteki gezinmeye ekledi.

Konuyu değiştir

Yukarıdakilerin hepsine ek olarak, konuyu kolayca değiştirebiliriz. Depoda Pelikan temaları, kullanıcıların oluşturduğu farklı temaları bulabilirsiniz.. Yeni temaları test etmek çok kolay, sadece onları depodan indirmeniz gerekiyor, bunları bilgisayarımıza kaydedin ve pelicanconf.py dosyasına temanın yolunu içeren aşağıdaki satırı ekleyin:

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

Geliştirici sunucusu çıktısını yeniden oluşturacaktır. Yeni temayı görmek için web sayfasını tarayıcıda yeniden yükleyin.

Bu, Pelikan'a kısa bir giriş oldu. Bütün bunlar yerel bir makinede yapıldı. Başkalarının sitenizi görmesini istiyorsanız, önceden oluşturulmuş HTML dosyalarını bir sunucuya yüklemeniz gerekir.. Çıktısına ayrıntılı olarak bakarsanız pelikan-hızlı başlangıç, FTP, SSH, S3 ve hatta GitHub sayfalarını kullanma seçeneklerini göreceksiniz.

Bu olabilir bu jeneratör hakkında daha fazla bilgi edinin proje web sitesi veya senin GitHub deposu.


Yorumunuzu bırakın

E-posta hesabınız yayınlanmayacak. Gerekli alanlar ile işaretlenmiştir *

*

*

  1. Verilerden sorumlu: Miguel Ángel Gatón
  2. Verilerin amacı: Kontrol SPAM, yorum yönetimi.
  3. Meşruiyet: Onayınız
  4. Verilerin iletilmesi: Veriler, yasal zorunluluk dışında üçüncü kişilere iletilmeyecektir.
  5. Veri depolama: Occentus Networks (AB) tarafından barındırılan veritabanı
  6. Haklar: Bilgilerinizi istediğiniz zaman sınırlayabilir, kurtarabilir ve silebilirsiniz.