Membuat blog di Github Pages dengan Pelican

 Pelican adalah utilitas yang dapat kamu gunakan untuk membuat weblog dengan hanya menggunakan berkas teks. Berkas dapat berupa format reStructured Text atau Markdown, dimana keduanya mudah untuk dipelajari. Seperti perangkat lunak blog lainnya, kamu dapat membuat artikel berbasis waktu atau halaman statis. Pelican mendukung umpan, alat analisa eksternal, dan dapat mengimport dari WordPress atau umpan lainnya.

Github, layanan hosting terpopuler untuk kode sumber terbuka, memberikan yang simpel, solusi website yang elegan untuk pryek yang dihosting disana. Github Pages mengizinkan pengguna untuk menyimpan halaman konten di repositori git bersama dengan kode mereka. Dengan mengkombinasikan Pelican dengan Github Pages, kamu dapat mempunyad situs blog yang dapat diandalkan dan atraktif untuk proyek anda.

-Pelican mungkin alat blg berbasis teks namun dia juga dapat memproduksi blg yang cantik:

pelican-screenshot1-1024x707di Blog Pelican semuanya dapat kamu kustomisasi, seperti yang kamu lihat diatas, tema tersebut adalah Chunk. Terdapat ribuan yang tersedia di web, termasuk yang responsive dan berbasis bootstrap.

Sekarang kamu sudah melihat nilai dari Pelican, mari kita mulai membuat situs. Kamu harus sudah terbiasa dengan perintah git untuk mengikut langkah-langkah di artikel ini.

Mengatur halaman github.io

Untuk membuat halaman pengguna Gitub, masuk log ke Github dan buat dua repositori baru, namapengguna.github.io-src dan namapengguna.github.io, seperti yang dijelaskan di halaman Github. (Gunakan nama pengguna Gitub kamu untuk repositori tersebut.) Repositori namapengguna.github.io-src akan memuat sumber blog kamu dan namapengguna.github.io mengandung hasil berkas keluaran HTML Pelican. Untuk menambah direktori keluaran sebagai submodul,inisiasikan dengan berkas README.

Instal Pelican

Di Fedora, ini merupakan perintah yang sangat simpel:

sudo dnf install python-pelican

Klon repositori sumber yang sudah kamu buat:

git clone git@github.com:namapengguna/namapengguna.github.io-src ghpages

Kemudian ubah direktori ke situs:

cd ghpages

Mengatur blog dengan Pelican

Periksa dua kali bahwa kamu sedang bekerja di repositori sumber gi menggunakan:

git remote -v

Kamu seharusnya melihat bahwa kamu sedang menggunakan repositori namapengguna.github.io-src. Kemudian, klon keluaran repositori sebagai submodul git (pengganti nama pengguna Github anda):

git submodule add git@github.com:namapengguna/namapengguna.github.io.git output

Pelican menyediakan perintah mulaicepat. Jalankan dengan:

pelican-quickstart

Mulaicepat akan menanyakan kamu beberapa pertanyaan, dimana kamu dapat menjawabnya bergiliran. Ini beberapa jawaban spesifik yang harus kamu berikan:

  • Dimana kamu ingin membuat situs baru kamu? (tekan Enter)
  • Prefix tautan: http://namapengguna.github.io
  • Hasilkan sebuah Fabfile/Makefile: Ya (untuk hampir semua pengguna)
  • Auto-reload & skrip simpleHTTP: Ya (untuk hampir semua pengguna)
  • Mekanisme unggah: pilih Tidak untuk semua kecuali Github Pages
  • Apakah ini halaman pribadi anda (namapengguna.github.io)? Ya

Kamu mungkin menerima pesan galat karena direktori keluaran telah ada. Ini tidak mengapa.

Buka berkas publishconf.py dan atur variabel DELETE_OUTPUT_DIRECTORY ke False. Sebaliknya, setiap waktu kamu publikasikan, Pelican menghapus submodule anda, dimana ini tidak kamu inginkan.

Oprek

Terdapat berbagai tips dan oprek yang ada disini yang mungkin kamu tertarik. Salah satu oprekan yang sangat berguna adalah perintah penambahan newpost diberkas Makefile.

Postingan pertama

Menulis postingan secara cepat, menggunakan Markdown atau format reStructured Text, di folder content.

Build, commit, push, selesai!

Setelah selesai, bangun blog anda dan uji coba hasilnya:

make html && make serve

Ini membangun blog, dan kemudian menjalankan webserver lokal di port 8000. Arahkan peramban anda kesana untuk melihat hasil kerja kamu. Jika semuanya OK, hasilkan situs:

make publish

Kemudian tambah berkas anda ke pelacak git, commit, dan push ke repositori. Karena penggunaan submodule, kamu harus melakukan ini dengan berkas keluaran sebelum kamu mempush berkas sumber.

cd output
git add .
git commit -m "First post."
git push -u origin master
cd ..
echo '*.pyc' >> .gitignore #don't need pyc files
git add .
git commit -m "First commit."
git push -u origin master

Sekarang, kamu dapat mengunjungi https://namapengguna.github.io  dan lihat situs yang baru saja kamu buat.

Peringatan dan kustomisasi

Semuanya dapat dikustomisasi di Pelican. Untuk memulai. kamu dapat memilih dari kumpulan tema. Terdapat juga kumpulan pengaya yang membantu anda menambahkan berbagai fungsi ke situs kamu. Tentu saja, kamu dapat menulisnya sendiri, atau mengkustomisasikan pengaya dan tema yang sudah ada.

Dokumentasi Pelican mengacu ku alat yang disebut ghp-pages, tapi Pelican versi 3.6.0 yang ada di Fedora 22 tidak dapat bekerja seperti yang dituliskan di dokumen. Metode submodule diatas akan membantu pekerjaan untuk masalah ini.

Gambar dari Manjith Kainickara – aslinya diposting ke Flickr sebagai American White Pelican.

By Ankur Sinha “FransiscoD” from Fedora Magazine

Iklan

Tinggalkan Balasan

Isikan data di bawah atau klik salah satu ikon untuk log in:

Logo WordPress.com

You are commenting using your WordPress.com account. Logout / Ubah )

Gambar Twitter

You are commenting using your Twitter account. Logout / Ubah )

Foto Facebook

You are commenting using your Facebook account. Logout / Ubah )

Foto Google+

You are commenting using your Google+ account. Logout / Ubah )

Connecting to %s