Salah satu fitur penting blog yang sering dicari adalah halaman kategori — halaman yang menampilkan semua artikel berdasarkan topik tertentu. Di WordPress ini sudah otomatis tersedia, tapi di Jekyll kamu perlu membuatnya sendiri.
Ada dua pendekatan: menggunakan plugin jekyll-archives, atau membuatnya secara manual tanpa plugin. Di artikel ini kita bahas keduanya, dengan fokus pada metode tanpa plugin yang kompatibel dengan semua hosting termasuk GitHub Pages.
Struktur Kategori di Jekyll
Di Jekyll, kategori didefinisikan di front matter setiap artikel:
---
layout: post
title: "Judul Artikel"
categories: [Tutorial, Jekyll]
---
Atau bisa juga dengan format array:
categories:
- Tutorial
- Jekyll
Jekyll akan otomatis mengumpulkan semua kategori dari semua artikel ke dalam variabel site.categories.
Cara 1: Satu Halaman untuk Semua Kategori
Cara paling sederhana adalah membuat satu halaman yang menampilkan semua kategori beserta artikel-artikelnya.
Buat file _pages/categories.html:
---
layout: page
title: Kategori
permalink: /categories/
---
{% assign categories_list = site.categories | sort %}
{% for category in categories_list %}
<section id="{{ category[0] | slugify }}">
<h2>{{ category[0] }} <span>({{ category[1] | size }})</span></h2>
<ul>
{% for post in category[1] %}
<li>
<a href="{{ post.url | relative_url }}">{{ post.title }}</a>
<small>{{ post.date | date: "%d %B %Y" }}</small>
</li>
{% endfor %}
</ul>
</section>
{% endfor %}
Hasilnya adalah satu halaman /categories/ yang menampilkan semua kategori dengan daftar artikelnya.
Cara 2: Halaman Terpisah per Kategori (Tanpa Plugin)
Untuk setiap kategori, kita buat file halaman sendiri secara manual di folder _pages/ atau folder category/.
Buat Layout Kategori
Buat file _layouts/category.html:
---
layout: default
---
<div class="category-header">
<h1>Kategori: {{ page.category_name }}</h1>
<p>{{ page.description }}</p>
</div>
<div class="post-list">
{% assign posts_in_category = site.posts | where_exp: "post", "post.categories contains page.category_name" %}
{% if posts_in_category.size == 0 %}
<p>Belum ada artikel di kategori ini.</p>
{% else %}
{% for post in posts_in_category %}
<article>
<h2><a href="{{ post.url | relative_url }}">{{ post.title }}</a></h2>
<p class="meta">{{ post.date | date: "%d %B %Y" }}</p>
<p>{{ post.excerpt | strip_html | truncatewords: 30 }}</p>
</article>
{% endfor %}
{% endif %}
</div>
Buat File Halaman per Kategori
Untuk setiap kategori, buat file markdown. Misalnya untuk kategori “Tutorial”:
_pages/category-tutorial.md:
---
layout: category
title: "Tutorial"
category_name: Tutorial
description: "Artikel-artikel panduan dan tutorial teknis."
permalink: /category/tutorial/
---
_pages/category-jekyll.md:
---
layout: category
title: "Jekyll"
category_name: Jekyll
description: "Tips dan trik seputar Jekyll Static Site Generator."
permalink: /category/jekyll/
---
_pages/category-security.md:
---
layout: category
title: "Security"
category_name: Security
description: "Artikel seputar keamanan web dan cybersecurity."
permalink: /category/security/
---
Cara 3: Menggunakan Plugin jekyll-archives (Untuk Cloudflare Pages / Self-hosted)
Jika kamu deploy ke Cloudflare Pages, Netlify, atau server sendiri (bukan GitHub Pages mode klasik), kamu bisa menggunakan plugin jekyll-archives yang otomatis membuat halaman per kategori.
Instalasi
Tambahkan ke Gemfile:
gem "jekyll-archives"
Jalankan:
bundle install
Konfigurasi di _config.yml
plugins:
- jekyll-archives
jekyll-archives:
enabled:
- categories
- tags
layouts:
category: category-archive
tag: tag-archive
permalinks:
category: "/category/:name/"
tag: "/tag/:name/"
Buat Layout _layouts/category-archive.html
---
layout: default
---
<h1>Kategori: {{ page.title }}</h1>
{% for post in page.posts %}
<article>
<h2><a href="{{ post.url }}">{{ post.title }}</a></h2>
<p>{{ post.date | date: "%d %B %Y" }}</p>
</article>
{% endfor %}
Dengan konfigurasi ini, Jekyll akan otomatis membuat halaman /category/tutorial/, /category/jekyll/, dst. untuk setiap kategori yang ada.
Menambahkan Link Kategori ke Artikel
Di layout post (_layouts/post.html), tambahkan link ke halaman kategori:
{% if page.categories %}
<div class="categories">
{% for category in page.categories %}
<a href="/category/{{ category | slugify }}/" class="category-badge">
{{ category }}
</a>
{% endfor %}
</div>
{% endif %}
Menambahkan Kategori ke Menu Navigasi
Di _config.yml, kamu bisa mendefinisikan menu navigasi:
nav_links:
- title: Tutorial
url: /category/tutorial/
- title: Jekyll
url: /category/jekyll/
- title: Security
url: /category/security/
Lalu di layout header:
{% for link in site.nav_links %}
<a href="{{ link.url }}">{{ link.title }}</a>
{% endfor %}
Kesimpulan
Membangun halaman kategori di Jekyll bisa dilakukan tanpa plugin sama sekali — cukup dengan Liquid templating dan beberapa file halaman. Untuk skalabilitas yang lebih baik, plugin jekyll-archives adalah solusi otomatis yang sangat memudahkan, terutama ketika jumlah kategori terus bertambah.
Pilih pendekatan yang sesuai dengan kebutuhan dan tempat hosting kamu.