Pelican, generator situs statis berbasis Python

tentang pelikan

Pada artikel berikutnya kita akan melihat Pelican. Ini adalah opsi yang bagus untuk pengguna Python yang ingin menghosting sendiri situs web atau blog sederhana. Jika Anda tertarik untuk membuat situs web atau blog khusus, Anda memiliki banyak pilihan yang tersedia saat ini. Tapi jika saja Anda ingin menyajikan halaman web statis, pembuat situs statis ini mungkin berguna untuk Anda. Jenis aplikasi ini menggunakan templat untuk membuat semua halaman statis yang diinginkan pengguna, dan menautkannya dengan metadata terkait.

Jika Anda menggunakan Ular sanca dan Anda mencari sesuatu untuk menghasilkan halaman HTML statis, generator ini akan memungkinkan Anda untuk melihat internal cara kerjanya. Menggunakan bahasa yang Anda tahu membuatnya lebih mudah. Jika Anda tidak menyukai Python, ada generator situs statis lain yang menggunakan bahasa lain.

Pelican adalah generator situs statis yang umum digunakan yang ditulis dengan Python. Timur langsung mendukung reStructuredText dan dapat mendukung penurunan harga, ketika paket yang diperlukan diinstal. Semua tugas dilakukan melalui alat antarmuka baris perintah (CLI), yang membuatnya mudah bagi siapa saja yang mengenalnya. Selain itu, alat mulai cepat yang sederhana membuat pembuatan situs web menjadi sangat mudah.

Instalasi Pelican dan Konfigurasi Dasar

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

penciptaan lingkungan virtual

mkdir test-sitio

cd test-sitio

python3.8 -m venv venv

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

Setelah memperbarui pip, sekarang kita bisa instal Pelican:

fasilitas pelikan

./venv/bin/pip install pelican

Jalankan perintah pelican-quickstart

Setelah diinstal, alat CLI Mulai Cepat Pelican akan membuat tata letak dasar dan beberapa file sehingga kami dapat memulai.

Untuk mempermudah, saat menjalankan quick start saya menggunakan nilai untuk judul dan penulis dan menjawab N ke awalan url dan pagination artikel. Untuk sisa pertanyaan, saya menggunakan default. Sangat mudah untuk mengubah pengaturan ini di file konfigurasi nanti. Mulai cepat dapat dijalankan dengan perintah:

pelikan cepat memulai

./venv/bin/pelican-quickstart

Setelah selesai, kita dapat mengubah aspek tertentu dari pengaturan. Kami hanya harus buka file pelicanconf.py di editor teks favorit kami.

file konfigurasi

Di dalam kita dapat mencari baris:

TIMEZONE = 'Europe/Paris'

Dan kita bisa ubah ke zona waktu negara yang Anda minati.

untuk perbarui pengaturan tautan sosial, Anda harus mencari variabel SOSIAL en pelicanconf.py. Di dalamnya kita dapat menambahkan link kita sebagai berikut:

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

Anda harus mencatat bahwa koma di akhir itu penting. Koma itu membantu Python mengenali bahwa variabel sebenarnya adalah satu set. Pastikan Anda tidak menghapusnya.

Mulai server

Sekarang setelah kita memiliki dasar-dasar sebuah situs, kita dapat melihat bahwa quickstart membuat Makefile dengan berbagai tujuan. Salah satunya membuat devserver dapat memulai server pengembangan di mesin kami sehingga kami dapat melihat pratinjau semua yang kami buat. Perintah CLI yang digunakan dalam Makefile seharusnya menjadi bagian dari PATH kita, jadi pertama-tama kita harus mengaktifkan virtualenv.

mulai server

source ./venv/bin/activate

make devserver

Saat itu dimulai, kita bisa buka browser kami dan pergi ke URL http://localhost:8000 untuk melihat blog yang telah dibuat.

halaman contoh yang dibuat dengan Pelican

Tambah isi

Sekarang kita memiliki situs dasar, kita dapat menambahkan beberapa konten. Pertama, kami akan membuat file bernama selamat datang di direktori konten (Konten) dari situs.

Dengan editor teks favorit kami, kita akan membuat file ini dengan teks yang mengikuti struktur berikut:

tambahkan konten di 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.).

Setelah menulis file, devserver harus memperbarui dan menghasilkan sesuatu seperti ini:

file selamat datang ditambahkan

Muat ulang situs pengujian Anda di browser untuk melihat perubahannya.

halaman selamat datang statis

Metadata secara otomatis ditambahkan ke halaman. Apalagi, Pelican secara otomatis mendeteksi kategori Intro dan menambahkan bagian ke navigasi teratas.

Ganti topik

Selain semua hal di atas, kita dapat dengan mudah mengubah topik pembicaraan. Di repositori Pelikan-tema, Anda dapat menemukan berbagai tema yang telah dibuat pengguna. Sangat mudah untuk menguji tema baru, Anda hanya perlu mengunduhnya dari repositori, simpan di komputer kita dan di file pelicanconf.py tambahkan baris berikut dengan path ke tema:

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

Devserver akan membuat ulang outputnya. Muat ulang halaman web di browser untuk melihat tema baru.

Ini adalah sedikit pengenalan singkat tentang Pelican. Semua ini dilakukan pada mesin lokal. Jika Anda ingin orang lain melihat situs Anda, Anda harus mengunggah file HTML yang telah dibuat sebelumnya ke server. Jika Anda melihat secara detail pada output dari pelican-mulai cepat, Anda akan melihat opsi untuk menggunakan FTP, SSH, S3, dan bahkan halaman GitHub.

Hal ini dapat dapatkan informasi lebih lanjut tentang generator ini di situs proyek atau di Anda Repositori GitHub.


Jadilah yang pertama mengomentari

tinggalkan Komentar Anda

Alamat email Anda tidak akan dipublikasikan. Bidang yang harus diisi ditandai dengan *

*

*

  1. Penanggung jawab data: Miguel Ángel Gatón
  2. Tujuan data: Mengontrol SPAM, manajemen komentar.
  3. Legitimasi: Persetujuan Anda
  4. Komunikasi data: Data tidak akan dikomunikasikan kepada pihak ketiga kecuali dengan kewajiban hukum.
  5. Penyimpanan data: Basis data dihosting oleh Occentus Networks (UE)
  6. Hak: Anda dapat membatasi, memulihkan, dan menghapus informasi Anda kapan saja.