Update Docs (Dokumentasi)
Lokasi dan alamat
- Folder:
src/content/docs/ - Nama file
judul-dokumen.mdmenjadi/docs/judul-dokumen - Tampil di halaman Docs, seksi Documentation di beranda (5 teratas), sidebar kiri halaman dokumen (dikelompokkan per kategori), dan pencarian.
Field yang tersedia
| Field | Isi |
|---|---|
title, description | Judul dan ringkasan |
category | Teks bebas untuk mengelompokkan, misalnya “Python Tools”. Dokumen berkategori sama muncul satu kelompok |
order | Angka pengurut di dalam kategori; angka kecil tampil lebih atas |
version | Opsional, misalnya v1.0 |
lastModified | Tanggal pembaruan, format 2026-09-27; ini yang tampil sebagai tanggal |
featured | true agar diprioritaskan di beranda |
draft, hideTOC, noIndex | true atau false |
Dokumen tidak memakai field date.
Template
---
title: "Judul Dokumen"
description: "Ringkasan dokumen."
category: "Nama Kategori"
order: 1
draft: false
featured: false
version: ""
lastModified: 2026-09-27
hideTOC: false
noIndex: false
---
## Bagian pertama
Isi dokumen.
Menambah dokumen
Lewat CMS: buka /admin, pilih Docs, klik New Docs, isi, lalu Publish.
Manual: buat file baru di src/content/docs/, tempel template, isi, uji dengan pnpm dev, lalu commit dan push.
Membuat kategori baru
Tidak ada langkah khusus. Cukup tulis nama kategori baru di field category. Semua dokumen dengan nama kategori yang sama otomatis berkelompok di sidebar.
Mengatur urutan
Gunakan order yang berurutan (1, 2, 3, …) di setiap kategori. Untuk menyisipkan dokumen di tengah, beri nomor kelipatan misalnya 10, 20, 30 supaya mudah menyisip.
Tips
- Tulis nama kategori persis sama di semua dokumen, karena huruf besar kecil dan spasi dianggap berbeda.
- Kalau dokumen memuat blok kode yang berisi
---, pastikan berada di dalam pagar kode agar tidak dibaca sebagai frontmatter. - Perbarui
lastModifiedsetiap kali isi dokumen diubah bermakna.