Cara membuat kategori

Kategori bukan file konten. Semuanya didaftarkan di satu file: data/categories.yaml. Dari file itu Hugo membangun sidebar, halaman /categories/, kartu “Featured categories” di beranda, filter di /tools/, dan label kategori di setiap tool.

Halaman sebuah kategori (/categories/privacy/) baru dibuat setelah minimal satu tool memakainya. Kategori tanpa tool tetap tampil di sidebar dan /categories/, tetapi tautannya mengarah ke /tools/?category=privacy sampai ada isinya.

Format

privacy:
  name: Privacy
  icon: eye-off
  description: Lindungi data dan kurangi pelacakan.
  featured: true

internet:
  name: Internet
  icon: globe
  description: Peramban, jaringan, dan semua hal tentang web.

browser-tools:
  name: Browser Tools
  icon: app-window
  parent: internet
  description: Ekstensi dan utilitas yang memperbaiki peramban.

Field	Wajib	Isi
key (baris pertama, misal `privacy`)	ya	Slug. Huruf kecil, angka, tanda hubung. Ini yang ditulis di `categories:` pada tool dan menjadi URL
`name`	ya	Nama tampil
`description`	ya	Satu kalimat. Tampil di baris kategori dan di judul halaman kategori
`icon`	tidak	Nama ikon Lucide, misal `shield`, `code`, `brain`. Kalau kosong dipakai `folder`
`parent`	tidak	Key kategori induk. Membuat kategori ini menjadi sub-kategori
`featured`	tidak	`true` = tampil di “Featured categories” beranda

Nama ikon harus persis seperti di Lucide, dengan tanda hubung: square-terminal, eye-off, gamepad-2. Kalau namanya salah, build tetap jalan tetapi ada peringatan icon "…" not found dan ikonnya kosong.

Hierarki

Cukup satu tingkat: induk dan anak. Beri parent: <key-induk> pada anak. Induknya tidak perlu tahu apa-apa.

Yang terjadi dengan hierarki:

Sidebar menampilkan anak menjorok di bawah induknya dengan garis kiri.
Halaman /categories/ mengelompokkan anak di bawah induk.
Halaman kategori induk menampilkan daftar sub-kategorinya di atas daftar tool.
Tool yang diberi categories: [browser-tools] tidak otomatis masuk ke internet. Kalau ingin muncul di keduanya, tulis keduanya: categories: [internet, browser-tools].

Urutan tampil

Kategori diurutkan berdasarkan key secara alfabet, bukan urutan di file. Kalau ingin urutan khusus, awali key dengan angka tidak disarankan karena ikut ke URL. Pilihan yang lebih bersih: biarkan alfabet, dan gunakan featured: true untuk yang ingin ditonjolkan di beranda.

Mengganti nama atau menghapus

Ganti name, icon, atau description: aman, tidak ada yang perlu diubah di tool.
Ganti key (misal dev menjadi developer): cari semua tool yang memakainya dan ubah categories: di sana. Build akan gagal dan menyebut file mana yang masih memakai key lama, jadi tidak akan terlewat.
Hapus kategori: hapus entrinya, lalu perbaiki tool yang masih memakainya. Sama, build memberi tahu.

Cara cepat mencari pemakai key lama dari terminal:

grep -rl "dev" content/tools

Kategori yang tampil di mana

Tempat	Sumber
Sidebar	semua kategori, induk dan anak
Beranda, “Featured categories”	kategori dengan `featured: true`
`/categories/`	semua kategori, berkelompok
Filter di `/tools/`	hanya kategori yang punya minimal satu tool, dengan jumlahnya
Baris tool	kategori pertama di `categories:` tool tersebut

Platform dan pricing

Dua registry lain bekerja dengan cara yang sama tetapi lebih sederhana, tanpa hierarki dan tanpa featured:

# data/platforms.yaml
macos: { name: macOS, icon: laptop }

# data/pricing.yaml
free: { name: Free, description: Sepenuhnya gratis. }

Key-nya dipakai di platforms: dan pricing: pada tool, dan URL-nya /platforms/macos/ serta /pricing/free/.