Sebelum bikin blog menggunakan jekyll pada github pages ini, sebelumnya saya sudah pernah buat github static page (without jekyll, only using html js and css). Jadi karena sudah terlanjut punya static page yang saya gunakan untuk portofolio online yang bisa di akses disini. Rasanya sayang untuk bikin github page ini jadi full jekyll (belum lagi mikirin bagaimana mindahin portfolio yang sudah ada ini ke format jekyll).
Lalu yang saya inginkan itu nambah blog pada github page yang sudah ada itu, tanpa harus mengubah portofolio yang hanya html css dan js ke format jekyll. caranya bagaimana ? saya terpikir untuk buat blog menjadi page baru yaitu https://sukorenomw.github.io/blog.
Prologue
awalnya saya coba buat folder baru di repository yang sudah ada, bernama blog, lalu saya setup jekyll disana (banyak sekali tutorial setup jekyll di github page, salah satunya ini). ternyata cara yang ini gagal, tidak semudah yang di bayangkan.
Lalu sempat cari-cari tutorial di google, ada beberapa tutorial, tapi hampir semua nya tidak jelas, mungkin susah di baca bagi orang awam yang baru pertama kali setup jekyll, akhirnya saya menemukan yang agak jelas (walaupun masih belum jelas untuk seorang awam) yaitu blog dari Eamonn Bell, dan akhirnya setelah baca-baca darisana, saya berhasil juga bikin blog ini dan akhirnya saya putuskan untuk membuat cara setup step-by-step yang lebih jelas, sekaligus dokumentasi apa yang saya lakukan.
How to setup jekyll in subdirectory
-
langkah pertama yang perlu dilakukan adalah, membuat repository baru di github, karena saya mau buat blog dengan link baru : /blog, maka saya buat repository bernama blog.
-
setup jekyll pada repository tersebut, saya anggap pembaca sudah bisa setup jekyll, jika belum silahkan scroll ke atas.
-
yang
palingpenting adalah, untuk membuat subdirectory pada github page, kita harus membuat branch bernama gh-pages, jadi semua commit harus masuk ke branch ini, bukan branch master -
ternyata ini bagian paling penting, kita harus mengubah beberapa setting di config.yml
baseurl: "/blog" production_url : http://<username>.github.io/blog
dan voila .. setelah itu, kita bisa akses https://sukorenomw.github.io/blog