BaseUrl adalah sebuah baris konfigurasi pada berkas config.yml yang cukup merepotkan jika tidak dipahami untuk apa penggunaannya. Akibat dari kesalahan penggunaan baseurl adalah berantakannya alamat URL seperti yang saya alami. Ketika website dibuka menggunakan URL lokal semuanya terlihat baik-baik saja, tapi ketika dibuka menggunakan URL github atau URL modifikasi, maka sebagian dari konten website tidak tampil karena URL atau alamat kontennya salah.
Jika didalam berkas config.yml “baseurl :” dibiarkan kosong, maka ketika perintah serve
dipanggil secara otomatis akan diarahkan ke alamat http://127.0.0.1:4000
.
Berbeda jika “baseurl :” diisi dengan nilai “/blog” misalnya. Ketika perintah serve
dipanggil maka akan diarahkan ke alamat http://127.0.0.1:4000/blog
, artinya ada tambahan alamat baseurl “/blog” dari alamat yang sebelumnya http://127.0.0.1:4000
.
Penting untuk diingat, jika menggunakan baseurl
maka ketika membuat link didepannya harus diikutkan dengan /blog/path/path/path/berkas.type
.
Misalnya :
<link rel="stylesheet" href="/blog/assets/style/css/syntax.css">
Alamat linknya nanti akan jadi /blog/assets/style/css/syntax.css
Jika tidak menggunakan baseurl
maka kode /blog
tidak perlu ditambahkan.
Seperti yang dijelaskan diatas, ketika menggunakan baseurl maka ada tambahan /blog setelah bagian DOMAIN:PORT. Jadi baseurl digunakan apabila kita ingin ada tambahan setelah DOMAIN:PORT. Tetapi kelihatannya baseurl lebih kompleks dari sekedar menambahkan alamat didepan DOMAIN:PORT, masih butuh waktu untuk benar-benar memahami.
[1] Configuring Jekyll for User and Project GitHub Pages
[2] Clearing Up Confusion Around baseurl