Repositori ini berisi tema untuk Pelican. Jangan ragu untuk mengkloning, menambahkan tema Anda sendiri, dan mengirimkan permintaan penarikan. Ini dikelola komunitas!
Versi langsung dapat dilihat di http://www.pelicanthemes.com.
Petunjuk ini mengasumsikan Anda telah membaca semua dokumentasi Pelican, memiliki situs yang berfungsi, dan sekarang ingin menerapkan tema non-default.
Pertama, pilih lokasi untuk mengadakan tema Anda. Untuk contoh ini, kami akan menggunakan direktori ~/pelican-themes
, tetapi direktori Anda mungkin berbeda. Kloning repositori pelican-themes
ke lokasi tersebut di mesin lokal Anda:
git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes
Sekarang Anda seharusnya menyimpan repositori pelican-themes
di ~/pelican-themes/
.
Untuk menggunakan salah satu tema, edit file pengaturan Pelican Anda untuk menyertakan baris ini:
THEME = "/home/user/pelican-themes/theme-name"
Jadi, misalnya, untuk menggunakan tema mnmlist
, Anda perlu mengedit file pengaturan untuk menyertakan:
THEME = "/home/user/pelican-themes/mnmlist"
Simpan perubahan pada file pengaturan Anda dan kemudian buat ulang situs Anda dengan menggunakan Makefile yang seharusnya sudah Anda siapkan menggunakan pelican-quickstart
:
make html
Tema juga dapat ditentukan secara langsung melalui parameter -t ~/pelican-themes/theme-name
ke perintah pelican
. Jika Anda ingin mengedit tema Anda, pastikan bahwa setiap pengeditan yang Anda lakukan dilakukan pada salinan yang disimpan di ~/pelican-themes/theme-name
. Setiap perubahan yang dilakukan pada file yang disimpan di direktori output
situs Anda akan dihapus saat Anda membuat situs lagi.
Pembuatan pratinjau tema terjadi secara otomatis melalui alur kerja GitHub Actions, setelah itu pratinjau tersebut dipublikasikan ke https://pelicanthemes.com. Jika Anda ingin membuat pratinjau secara lokal di stasiun kerja Anda, kloning repositori Pelican (misalnya, ke ~/projects/pelican/), kloning repositori ini di suatu tempat, ubah ke direktori akar klon tersebut, dan ikuti langkah-langkah berikut:
python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py