Pelican adalah sebuah tool SSG (STATIC SITE GENERATOR) yang dibuat dengan bahasa python,right? oke, sebelum lebih jauh lebih baik kita mengenal apa itu ssg dulu.

jika kita translate dalam bahasa indonesia ssg adalah penghasil website statis yang mana website statis ini tidak memerlukan database maupun server-side logic (backend) hanya didasari oleh html, css dan javascript. tentu ini akan membuat website kamu bakalan ngebut karena tidak terlalu banyak melakukan request ke backend. nah blog archiko ini sendiri juga dibuat dengan pelican.

Kita masuk ke langkahnya

Buat repositori baru

Diakun github kalian buat satu repo sama dengan username kalian, diakhir dengan .github.io, seperti dibawah ini.

github.com/username/username.github.io

karena pelican merubah sebuah konten dari markdown menjadi html, kalian juga install Markdown. kita gunakan pip python untuk install nya :D

$ pip install pelican ghp-import Markdown

kloning repositori

selanjutnya kakian bisa clone repositorynya dan menambahkan blog diakhir nama repo untuk menggubah nama foldernya menjadi blog. kalian bebas beri nama apapun.

$ git clone https://github.com/username/username.github.io blog
$ cd blog

Tips

karena nanti file-file konfigurasi pelican bakalan muncul dihalaman pengguna (direpositori username.github.io) dengan cabang master, kita bisa memilah nya menjadi dua cabang, untuk file-file konfigruasinya kita taruh dicabang baru dengan nama content. sedangkan untuk hasil konten web dari pelican kita taruh dicabang master.

ini akan memudahkan kita nantinya jika ingin menghapus seluruh halaman/konten dalam websitenya karena hanya ada dicabang master dan kita bisa mengisinya lagi dari cabang content.

paham? semoga….

$ git checkout -b content
Switched to a new branch 'content'

Konfigurasi pelican

Ditahap ini kita akan melakukan konfigurasi pelican. Untuk inisialisasi gunakan perintah pelican-quickstart. Nanti kalian disuruh menjawab serangkaian pertanyaan.

$ pelican-quickstart
Welcome to pelican-quickstart v4.6.0.

This script will help you create a new Pelican-based website.

Please answer the following questions so this script can generate the files
needed by Pelican.


> Where do you want to create your new web site? [.] .
> What will be the title of this web site? Anime Streaming
> Who will be the author of this web site? Hiro
> What will be the default language of this web site? [en]
> Do you want to specify a URL prefix? e.g., https://example.com   (Y/n) n
> Do you want to enable article pagination? (Y/n) y
> How many articles per page do you want? [10]
> What is your time zone? [Europe/Paris] Asia/Jakarta
> Do you want to generate a tasks.py/Makefile to automate generation and publishing? (Y/n) y
> Do you want to upload your website using FTP? (y/N) n
> Do you want to upload your website using SSH? (y/N) n
> Do you want to upload your website using Dropbox? (y/N) n
> Do you want to upload your website using S3? (y/N) n
> Do you want to upload your website using Rackspace Cloud Files? (y/N) n
> Do you want to upload your website using GitHub Pages? (y/N) y
> Is this your personal page (username.github.io)? (y/N) y
Done. Your new project is available at /root/blog

untuk bagian upload your site using github pages kalian pilih “y” karena dalam toturial ini kita bakalan hosting nya digithub.

coba sekarang kalian lihat isi foldernya.

$ ls
Makefile  content  output  pelicanconf.py  publishconf.py  tasks.py

Push!

Setalah file-file diatas sudah ada, kita push ke repositori yang dibuat tadi dengan cabang konten.

$ git add .
$ git commit -m "-"
$ git push origin content

Maap jika info commitnya hanya “-” karena saya bingung mau isi dengan apa wkwk

Menambahkan sebuah postingan

Yap disini kalian sudah bisa menambahkan artikel atau postingan.
Ayo kita tambahkan 1 postingan dan 1 halaman untuk about.

$ cd content && mkdir pages
$ touch pages/about.md
$ touch post-1.md

Buka file post-1.md dengan kode editor kesayangan kalian.
tambahkan judul, tanggal, author dan isi konten.

Title: Hallo Dunia!
Date: 24, sep 2027
Author: Hero

# Halo Dunia!
Ini adalah isi konten pertama saya menggunakan pelican.

nah sekarang kalian coba buka file pages/about.md dan tambahkan seperti dibawah ini.

Title: About
Date: 24, sep 2027

## About
Hai nama gua hero dan terimakasih telah memberikan
gua kesemepatan untuk menemani malam sedih mu.

Sekarang dicabang content kita memiliki 1 halaman dan 1 postingan. sekarang kita tinggal publish ini kehalaman github pages kita.

Publish

Oke, kalian ada ditahap terakhir, waktunya untuk mempublish halaman kita.

• jalankan pelican untuk membuat file statis htmlnya dengan keluaran dipath output:

$ pelican content -o output -s publishconf.py

• gunakan ghp-import untuk menambahkan isi konten dioutput tadi kecabang master:

$ ghp-import -m "-" --no-jekyll -b master output 

• sekarang tinggal kita push kecabang lokal masternya.

$ git push origin master

• lakukan push dan commit lagi untuk menambahkan halaman dan post yang sudah dibuat tadi kecabang content

$ git add content
$ git commit -m "-"
$ git push origin content

setup halaman github pages

selanjutnya kalian hanya tinggal buka halaman repository github kalian dan masuk kebagian settings > pages.



nanti kalian ubah opsi none yang ada disource ke branch master. lalu save!

Finally ~

Sekarang halaman github pages kalian sudah siap untuk dikunjungi!

https://username.github.io/