Pindahan (lagi)?

Sepertinya ini pindahan yang ke tiga kalinya. Pertama dari blogspot lalu ke wordpress lalu ke octopress dan sekarang adalah pindahan yang mudah-mudahan yang terakhir kalinya ke jekyll. Pindahan itu gak enak, seperti dari zona nyaman ke zona tidak nyaman. Pindahan itu ribet, repot dan lelah. Pindahan itu kadang kita harus belajar lagi dari awal atau beradaptasi lagi dengan sistem yang baru. Tetapi pindahan juga ada positifnya. Kita belajar hal baru, punya pengetahuan baru dan yang pasti saya jadi ada topik untuk menulis tulisan baru.

Pada dasarnya jekyll itu merupakan induk dari octopress, jadi seharusnya tidak banyak masalah. Tetapi saya sudah kadung terbiasa menggunakan octopress, untuk menggunakan jekyll harus ada adaptasi sedikit. Seperti untuk menulis tulisan baru pada octopress dengan perintah rake new_post[judul] sedangkan pada jekyll tidak ada perintah itu. Langsung saja tulis berkas dengan format markdown, tetapi nama berkasnya harus sesuai dengan format jekyll yaitu tahun-bulan-tanggal-namafile.md. Cara menginstall jekyll ada pada tulisan ini. Untuk tulisan kali ini saya akan membahas perubahan apa saja yang saya buat untuk pindahan kali ini.

Tema

Tema yang saya gunakan adalah lanyon. Kemudian saya mencontoh beberapa konfigurasi yang dibuat oleh pengguna lanyon. Seperti halaman pencarian yang saya dapat dari downtothewire. Selain itu saya juga menambahkan halaman arsip. Saya sangat suka sekali halaman arsip dimana kita bisa melihat tulisan-tulisan kita yang dikelompokkan per tahun. Potongan kode untuk menampilkan arsip pertahun dapat dilihat pada tautan https://gitlab.com/snippets/19412

Gambar

Jika sebelumnya pada octopress saya menggunakan Flickr untuk menyimpan foto ataupun gambar yang digunakan di tulisan-tulisan saya. Kali ini saya ingin yang lebih mudah tanpa harus menginstall plugins pada jekyll. Saya menggunakan dropbox sebagai penyimpan foto kemudian share link dan ditautkan ke tulisan. Berikut adalah contoh mensertakan foto yang berasal dari dropbox agak dapat bisa ditampilkan pada jekyll. Perhatikan raw=1 wajib ditambahkan apabila ingin ditampilkan pada halaman HTML biasa.

![jdul gambar](http://dropbox.com/asdfkjlv?raw=1)

Tulisan sebelum dan sesudah

Saya suka sekali pada tiap akhir tulisan ada tautan ke tulisan sebelumnya atau sesudahnya. Oleh karena itu saya tambahkan pada tiap post tautannya. Untuk itu saya harus merubah berkas post.html pada folder _layouts. Kode dapat dilihat pada tautan https://gitlab.com/snippets/19413

GitLab

Sesuai yang sudah saya bahas pada tulisan http://luthfi.idris.web.id/hosting-di-gitlab-pages/ bahwa hosting pada gitlab bukan hal mudah. Ini saya alami sendiri, butuh 2 hari bagi saya agak bisa dengan baik hosting jekyll di gitlab. Ini dikarenakan ada masalah pada berkas .gitlab-ci.yml yang merupakan berkas paling penting untuk hosting di gitlab. Contoh berkas .gitlab-ci.yml yang saya gunakan sebagai berikut

image: ruby:2.3

pages:
  script:
  - gem install jekyll jekyll-paginate
  - jekyll build -d public/
  artifacts:
    paths:
    - public
  only:
  - master

Ternyata direktori public merupakan direktori wajib ada yang digunakan gitlab untuk publish website. Sedangkan pada tema yang saya gunakan ada direktori public juga yang digunakan untuk menyimpan berkas .css ataupun gambar lainnya. Ini menjadi masalah sehingga saya harus mengganti nama public dengan nama lain dan merubah isi berkas head.html yang berisi tautan ke direktori public terdahulu. Setelah saya ganti, maka lancar jayalah semuanya.

Selain itu ada satu hal yang harus diperhatikan pada berkas _config.yml, untuk pengaturan baseurl dan url. Apabila menggunakan domain yang disediakan gitlab maka pengaturannya sebagai berikut

baseurl:	"\namaprojek"
url:		"http://username.gitlab.io"

Apabila menggunakan custom domain maka kosongkan baseurl dan ubah url menjadi nama domain yang anda punya.

Google Analytics

Selain itu kita juga harus setting ulang google analytics. Panduannya ada di https://desiredpersona.com/google-analytics-jekyll/

Tambah kategori, footnote dan pecarian

Footnote berguna untuk menggunakan referensi apabila kita mengutip sesuatu dari orang lain. Caranya tambahkan atau ganti markdown : kramdown pada _config.yml kemudian pada akhir kalimat yang akan kita berikan referensi tambahkan [^1] dan pada akhir tulisan tambahkan seperti

[^1] link ke referensi misalnya

Menambahkan kategori tiap post juga mudah sekali. Buat file kategori.md pada direktori utama jekyll yang isinya pada snippet ini. Kemudian pada berkas _layout/post.html tambahkan atau ubah tag class <div> post dengan kode pada snippet ini.

Pencarian bisa dengan membuat berkas cari.md kemudian isi dari file nya didapat dari link berikut.

Referensinya dari http://blog.pzheng.me/2014/07/03/Jekyll-Notes/

Selanjutnya

Saya akan membahas bagaimana menginstall jekyll pada Ubuntu 14.04.

Selingan

Ternyata blog ini bertambah dua pembacanya. Terima kasih sudah baca blog aku, jangan cuma baca tapi komentar juga ya.

Hallo kakak, hallo tante.