Pencarian & Navigasi

Cara kerja pencarian instan, indeks JSON, dan seluruh jalur navigasi di GitDocs.

Di halaman ini

Pencarian instan

Tekan Ctrl + K (⌘ + K di Mac) atau / dari mana saja untuk membuka panel pencarian.

Tombol	Fungsi
`↑` `↓`	Berpindah hasil
`Enter`	Membuka hasil
`Ctrl` + `Enter`	Membuka di tab baru
`Esc`	Menutup

Hasil dikelompokkan per halaman, dengan bagian yang cocok (judul H2/H3) tercantum di bawahnya — sehingga pembaca langsung melompat ke bagian yang tepat, bukan sekadar ke halaman.

Cara indeks dibangun

Saat halaman disimpan

Teks tiap bagian (dipotong per judul H2/H3) disimpan sebagai meta halaman.
Di akhir permintaan

Seluruh potongan digabungkan menjadi satu berkas JSON di uploads/gitdocs/search-index.json, lengkap dengan judul, jalur remah roti, URL, ikon, dan deskripsi.
Di peramban

Saat pencarian pertama kali dibuka, berkas JSON dan Fuse.js diunduh sekali lalu disimpan di memori. Pencarian berikutnya berjalan seketika, tanpa permintaan ke server.

Berkas indeks hanya memuat halaman yang sudah diterbitkan. Halaman berkata sandi hanya dimasukkan judulnya, dan draf tidak dimasukkan sama sekali.

Kualitas hasil

Pencarian memakai token search dengan pembobotan TF‑IDF:

Kata kunci dicocokkan per kata, jadi "warna gelap" tetap menemukan bagian "Warna aksen … mode gelap".
Semua kata harus cocok (AND), sehingga menambah kata akan mempersempit hasil.
Salah ketik kecil tetap termaafkan: "instlasi" tetap menemukan "Instalasi".
Judul halaman berbobot paling tinggi, disusul judul bagian, deskripsi, lalu isi.

JavaScript

// Bobot yang dipakai (assets/js/search.js)
keys: [
    { name: 't', weight: 3 },    // judul halaman
    { name: 'h', weight: 2.2 },  // judul bagian
    { name: 'd', weight: 1.1 },  // deskripsi
    { name: 'c', weight: 1 },    // isi
    { name: 'p', weight: 0.3 },  // jalur remah roti
]

Cakupan pencarian

Pada situs dengan lebih dari satu space, panel pencarian menampilkan pilihan space ini atau semua space. Bawaannya adalah space yang sedang dibuka.

Membangun ulang indeks

Indeks diperbarui otomatis setiap halaman disimpan, dipindah, atau dihapus. Untuk membangunnya ulang secara manual:

Bash

wp gitdocs reindex

Atau lewat tombol di Dokumentasi → Alat & Pengaturan.

Bila folder uploads tidak dapat ditulisi, GitDocs otomatis menyajikan indeks melalui endpoint REST /wp-json/gitdocs/v1/search-index. Situs tetap berfungsi, hanya sedikit lebih lambat.

Jalur navigasi lain

Pohon navigasi di kiri: cabang halaman aktif otomatis terbuka, dan posisinya digulir agar terlihat.
Daftar isi di kanan (≥ 1280 px): menyorot bagian yang sedang dibaca; di layar lebih kecil ia berubah menjadi daftar lipat di atas konten.
Remah roti di atas judul, lengkap dengan data terstruktur BreadcrumbList untuk mesin pencari.
Sebelumnya / Selanjutnya di bawah halaman, mengikuti urutan baca pohon (judul grup dilewati).
Tautan bagian: arahkan kursor ke judul, klik ikon rantai, dan tautan langsung tersalin.

Tanpa JavaScript

Pengunjung tanpa JavaScript tetap dapat menjelajah: navigasi, daftar isi, tab, dan akordeon semuanya berfungsi sebagai HTML biasa. Pencarian dialihkan ke halaman hasil ?s= yang dirender server dan hanya memuat halaman dokumentasi.