Cara Membuat Halaman Kategori di Jekyll Tanpa Plugin

Kiki/🎮🍉⌨️🍩💻
Kiki/🎮🍉⌨️🍩💻 • Aug 06, 2026 • 5 mins read
Cara Membuat Halaman Kategori di Jekyll Tanpa Plugin

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.


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.

Kiki/🎮🍉⌨️🍩💻
Written by
Kiki/🎮🍉⌨️🍩💻

hello I'm friend K.