config.yml
17 Apr 2025 -
Materi tentang config.yml
Apa Itu config.yml di Jekyll?
config.yml adalah file konfigurasi utama dalam proyek Jekyll, sebuah platform pembuat situs statis
berbasis Ruby. File ini menjadi pusat pengaturan yang menentukan bagaimana Jekyll membangun
dan merender website kamu.
Ibaratnya,config.yml adalah “panel kontrol” dari seluruh situs Jekyll milikmu.
Letak dan Format File,File ini selalu berada di direktori root proyek Jekyll
(sejajar dengan index.md, _posts/, dsb).Menggunakan format YAML
(YAML Ain’t Markup Language) yang sederhana dan bersih.Hanya boleh menggunakan spasi,
bukan tab.
Struktur Dasar config.yml
Contoh konfigurasi minimal untuk blog milik seorang pengguna bernama alisya:
title: Blog alisya
description: Berbagi cerita dan ilmu dengan dunia
url: “https://alisyateriana.github.io”
baseurl: “kosong jika tidak di subfolder”
theme: minima
Penjelasan:
Properti Fungsi
title Judul utama situs, ditampilkan di tab browser atau header description Deskripsi
singkat untuk SEO dan halaman utama url Alamat utama situs (jika dipublish ke GitHub Pages
atau domain pribadi) baseurl Diisi jika situs berada di subfolder, kosong jika langsung
di root theme Tema yang digunakan (default: minima, atau bisa diganti sesuai selera)
Menambahkan Plugin
Jekyll bisa diperluas dengan plugin, misalnya untuk feed, SEO, sitemap, dsb.
plugins:
-
jekyll-feed
-
jekyll-seo-tag
-
jekyll-paginate
jekyll-feed → Membuat feed RSS otomatis
jekyll-seo-tag → Menambahkan tag meta SEO
jekyll-paginate → Mengatur pagination artikel
Untuk menggunakan plugin di GitHub Pages, pastikan hanya memakai plugin yang didukung (whitelisted).
Pengaturan Penulis dan Metadata
author:
name: alisya teriana
email: alisyateriana@example.com
Digunakan untuk menampilkan nama dan kontak penulis di footer, sidebar, atau halaman post.
Struktur URL & Navigasi
permalink: /:title/
paginate: 6
paginate_path: “/halaman/:num”
permalink → Menentukan format URL postingan (default: /:categories/:year/:month/:day/:title.html)
paginate → Jumlah postingan per halaman (butuh jekyll-paginate)
paginate_path → Struktur URL untuk halaman selanjutnya
Markdown dan Highlighting
markdown: kramdown
highlighter: rouge
markdown: Mesin pemroses Markdown. Default Jekyll adalah kramdown.
highlighter: Untuk syntax highlighting di blok kode. Default: rouge.
Variabel Kustom (Custom Variables)
Kamu bisa menambahkan variabel khusus yang bisa dipanggil di layout atau template Jekyll:
yml social: github: https://github.com/alisyateriana
instagram: https://instagram.com/alisyateriana
linkedin: https://linkedin.com/in/alisyateriana
Di dalam file .html kamu bisa memanggilnya seperti ini:
Build Multi-Konfigurasi
Untuk membedakan antara build pengembangan (dev) dan produksi (prod):
bash jekyll build –config _config.yml,_config-dev.yml
Dengan cara ini, kamu bisa punya 2 versi file:
config.yml → Konfigurasi utama untuk produksi
config-dev.yml → Khusus untuk lokal/testing (misalnya menonaktifkan SEO tag atau analytics)
Tips Penting Gunakan 2 spasi untuk indentasi (bukan tab).
Tambahkan komentar dengan tanda #.
Jangan letakkan file config.yml di dalam folder — harus di root.
Restart server (jekyll serve) setiap kali mengubah _config.yml.
Kesimpulan
File config.yml adalah pusat pengaturan utama dalam proyek Jekyll.
Dengan file ini, kamu bisa: Menentukan identitas situs (judul, deskripsi, penulis)
Mengelola tema dan plugin, Mengatur struktur URL dan pagination
Menyimpan metadata khusus seperti media sosial atau lisensi
Ibaratnya, _config.yml adalah “panel kontrol” dari seluruh situs Jekyll milikmu.
Letak dan Format File File ini selalu berada di direktori root proyek Jekyll (sejajar dengan index.md, _posts/, dsb).
Menggunakan format YAML (YAML Ain’t Markup Language) yang sederhana dan bersih.
Hanya boleh menggunakan spasi, bukan tab.