Pelican, penjana laman web statik berasaskan Python

mengenai Pelican

Dalam artikel seterusnya kita akan melihat Pelican. Ini adalah pilihan yang baik untuk pengguna Python yang ingin menjadi hos laman web atau blog sendiri. Sekiranya anda berminat untuk membuat laman web atau blog khusus, hari ini anda mempunyai banyak pilihan. Tetapi sekiranya anda ingin melayan laman web statik, pembina laman web statik ini mungkin berguna untuk anda. Jenis aplikasi ini menggunakan templat untuk membuat semua halaman statik yang diinginkan pengguna, dan menghubungkannya dengan metadata yang berkaitan.

Sekiranya anda menggunakan Python dan anda mencari sesuatu untuk menghasilkan halaman HTML statik, penjana ini akan membolehkan anda melihat dalaman cara kerjanya. Menggunakan bahasa yang anda tahu menjadikannya lebih mudah. Sekiranya anda tidak menyukai Python, terdapat penjana laman web statik lain yang menggunakan bahasa lain.

Pelican adalah penjana laman web statik yang biasa digunakan yang ditulis dalam Python. Timur secara langsung menyokong reStructuredText dan boleh menyokong Markdown, apabila pakej yang diperlukan dipasang. Semua tugas dilakukan melalui alat antara muka baris perintah (CLI), yang menjadikannya mudah bagi sesiapa yang biasa dengannya. Di samping itu, alat permulaan cepatnya yang mudah menjadikan pembuatan laman web sangat mudah.

Pemasangan Pelican dan Konfigurasi Asas

Saya menguji program ini di Ubuntu 20.04. Langkah pertama yang akan diikuti adalah buat a virtualenv dan pasang Pelican. Ini dapat dilakukan dengan membuka terminal (Ctrl + Alt + T) dan menggunakan perintah di dalamnya:

penciptaan persekitaran maya

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Setelah mengemas kini pip, kita boleh sekarang pasang Pelican:

Kemudahan pelican

./venv/bin/pip install pelican

Jalankan arahan pelican-quickstart

Setelah dipasang, Pelican Quick Start CLI Tool akan membuat susun atur asas dan beberapa fail supaya kita dapat memulakannya.

Untuk memastikan perkara mudah, ketika menjalankan permulaan cepat saya menggunakan nilai untuk tajuk dan pengarang dan menjawab N ke awalan url dan penomboran artikel. Untuk soalan selebihnya, saya menggunakan lalai. Sangat mudah untuk mengubah tetapan ini dalam fail konfigurasi kemudian. Permulaan pantas dapat dijalankan dengan arahan:

pelican mulakan

./venv/bin/pelican-quickstart

Setelah selesai, kita dapat mengubah aspek tetapan tertentu. Kita hanya perlu buka fail pelicanconf.py di editor teks kegemaran kami.

fail konfigurasi

Di dalamnya kita dapat mencari garis:

TIMEZONE = 'Europe/Paris'

Dan kita boleh tukar ke zon waktu negara yang menarik minat anda.

kepada kemas kini tetapan pautan sosial, anda mesti mencari pembolehubah SOSIAL en pelicanconf.py. Di dalamnya kita boleh menambah pautan kita seperti berikut:

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

Anda harus perhatikan bahawa koma di akhir adalah penting. Koma itu membantu Python menyedari bahawa pemboleh ubah itu sebenarnya adalah satu set. Pastikan anda tidak menghapusnya.

Mulakan pelayan

Setelah kita mempunyai asas-asas laman web, kita dapat melihat bahawa langkah cepat membuat Makefile dengan pelbagai tujuan. Salah satu dari mereka membuat devserver boleh memulakan pelayan pengembangan pada mesin kami supaya kita dapat melihat semua yang kita buat. Perintah CLI yang digunakan dalam Makefile seharusnya menjadi sebahagian dari PATH kami, jadi pertama kita mesti mengaktifkan virtualenv.

memulakan pelayan

source ./venv/bin/activate

make devserver

Apabila ia bermula, kita boleh buka penyemak imbas kami dan pergi ke URL http://localhost:8000 untuk melihat blog yang telah dibuat.

halaman contoh dibuat dengan Pelican

Tambahkan kandungan

Sekarang kita mempunyai laman web asas, kita dapat menambahkan beberapa kandungan. Pertama, kami akan membuat fail yang dipanggil selamat datang.rst dalam direktori kandungan (kandungan) laman web.

Dengan penyunting teks kegemaran kami, kami akan membuat fail ini dengan teks yang mengikuti struktur berikut:

tambah kandungan dalam 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.).

Selepas menulis fail, devserver harus mengemas kini dan menghasilkan sesuatu seperti ini:

fail alu-aluan ditambah

Muat semula laman web ujian anda di penyemak imbas untuk melihat perubahannya.

halaman selamat datang statik

Metadata secara automatik ditambahkan ke halaman. Apa lagi, Pelican mengesan kategori Pengenalan secara automatik dan menambahkan bahagian tersebut ke navigasi teratas.

Tukar topik

Sebagai tambahan kepada semua perkara di atas, kita boleh menukar topik dengan mudah. Di repositori Tema Pelican, anda boleh menemui pelbagai tema yang telah dibuat oleh pengguna. Sangat mudah untuk menguji tema baru, anda hanya perlu memuat turunnya dari repositori, simpannya di komputer kita dan dalam fail pelicanconf.py tambahkan baris berikut dengan jalan ke tema:

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

Devserver akan menghasilkan semula outputnya. Muat semula halaman web dalam penyemak imbas untuk melihat tema baru.

Ini adalah pengenalan kecil yang cepat untuk Pelican. Semua ini dilakukan pada mesin tempatan. Sekiranya anda mahu orang lain melihat laman web anda, anda perlu memuat naik fail HTML yang telah dihasilkan ke pelayan. Sekiranya anda melihat secara terperinci output pelikan-permulaan cepat, anda akan melihat pilihan untuk menggunakan FTP, SSH, S3, dan juga halaman GitHub.

Ia boleh dapatkan lebih banyak maklumat mengenai penjana ini di laman web projek atau dalam anda Repositori GitHub.


Tinggalkan komen anda

Alamat email anda tidak akan disiarkan. Ruangan yang diperlukan ditanda dengan *

*

*

  1. Bertanggungjawab atas data: Miguel Ángel Gatón
  2. Tujuan data: Mengendalikan SPAM, pengurusan komen.
  3. Perundangan: Persetujuan anda
  4. Komunikasi data: Data tidak akan disampaikan kepada pihak ketiga kecuali dengan kewajiban hukum.
  5. Penyimpanan data: Pangkalan data yang dihoskan oleh Occentus Networks (EU)
  6. Hak: Pada bila-bila masa anda boleh menghadkan, memulihkan dan menghapus maklumat anda.