1. Apa itu _config.yml?

_config.yml adalah file konfigurasi utama dalam proyek Jekyll. File ini memegang semua pengaturan global yang memengaruhi bagaimana situs Anda dibangun, ditampilkan, dan dijalankan. Dengan file ini, Anda bisa mengatur berbagai hal seperti judul situs, deskripsi, plugin, URL dasar, struktur navigasi, hingga tema yang digunakan.

2. Format YAML: Dasar Penulisan

File _config.yml ditulis dalam format YAML (YAML Ain't Markup Language) yang sangat sensitif terhadap indentasi dan tidak boleh memakai tab. Gunakan 2 spasi untuk setiap level.

3. Contoh Umum _config.yml

title: Blog Yumna
description: Blog pribadi tentang pemrograman, desain, dan teknologi
baseurl: "/yumnaassyifa22" # sesuai nama repo GitHub Pages
url: "https://yumnaassyifa22.github.io"
theme: minima
plugins:
  - jekyll-feed
  - jekyll-seo-tag

author:
  name: Yumna Assyifa
  email: yumna@example.com

markdown: kramdown
highlighter: rouge
paginate: 5
paginate_path: "/page:num/"

4. Penjelasan Setiap Properti

• title: Nama situs yang muncul di tab browser dan hasil pencarian.
• description: Deskripsi pendek situs Anda.
• baseurl: Hanya diisi jika Anda menghosting di subfolder (misalnya GitHub Pages).
• url: Alamat domain situs Anda.
• theme: Tema yang digunakan (contoh: minima, jekyll-theme-cayman, dll).
• plugins: Plugin tambahan seperti SEO atau feed RSS.
• paginate: Jumlah postingan per halaman (jika menggunakan pagination).
• paginate_path: Format URL untuk pagination.
• markdown: Jenis markdown engine (biasa pakai kramdown).
• highlighter: Sintaks penyorot kode (contoh: rouge).

5. Menambahkan Navigasi Dinamis

Kita juga bisa membuat navigasi otomatis dengan menambahkan array menu:

nav:
  - title: Home
    url: /
  - title: Blog
    url: /blog/
  - title: Tentang Saya
    url: /about/

6. Custom Variable

Anda bisa menambahkan variabel kustom di _config.yml lalu memanggilnya di layout dengan Liquid syntax:

footer_text: "Hak Cipta © 2025 Yumna Assyifa"

Dan di HTML:

{{ site.footer_text }}

7. Tips & Trik

• Jangan lupa restart server setelah mengubah _config.yml.
• Selalu validasi YAML dengan yamlchecker.com.
• Gunakan komentar dengan tanda # untuk memberi catatan di file.
• Jika error, cek indentasi dan pastikan tidak ada spasi atau karakter aneh.

8. Kesalahan Umum

• Penggunaan tab daripada spasi
• URL tanpa tanda kutip yang mengandung karakter spesial
• Salah penempatan properti (misal: di bawah plugins salah indentasi)

9. Kesimpulan

_config.yml adalah jantung dari pengaturan situs Jekyll Anda. Semakin baik Anda memahami file ini, semakin fleksibel situs Anda bisa dibangun. Mulai dari tampilan, navigasi, sampai ke struktur blog, semua bisa dikendalikan dari sini.