Secara default, situs Starlight termasuk pencarian teks lengkap yang didukung oleh Pagefind, yang merupakan alat pencarian cepat dan bandwidth rendah untuk situs statis.
Tidak diperlukan konfigurasi untuk mengaktifkan pencarian. Bangun dan terapkan situs Anda, kemudian gunakan bilah pencarian di header situs untuk menemukan konten.
Sembunyikan konten dalam hasil pencarian
Kecualikan sebuah halaman
Untuk mengecualikan sebuah halaman dari indeks pencarian Anda, tambahkan pagefind: false ke frontmatter halaman:
Kecualikan bagian dari sebuah halaman
Pagefind akan mengabaikan konten di dalam elemen dengan atribut data-pagefind-ignore.
Dalam contoh berikut, paragraf pertama akan ditampilkan dalam hasil pencarian, tetapi isi dari <div> tidak akan:
Penyedia pencarian alternatif
Algolia DocSearch
Jika Anda memiliki akses ke Algolia’s DocSearch program dan ingin menggunakannya sebagai gantinya Pagefind, Anda dapat menggunakan plugin DocSearch Starlight resmi.
Tambahkan DocSearch ke konfigurasi plugins Starlight Anda di astro.config.mjs dan taruh appId, apiKey, and indexName Algolia Anda:
Dengan konfigurasi yang diperbarui ini, bilah pencarian di situs Anda sekarang akan membuka modal Algolia sebagai gantinya modal pencarian bawaan.
Menerjemahkan UI DocSearch
Secara default, DocSearch hanya menyediakan string UI dalam Bahasa Inggris.
Tambahkan terjemahan UI modal untuk bahasa Anda menggunakan internationalization system bawaan Starlight.
Perluas definisi koleksi konten i18n Starlight dengan skema DocSearch di src/content/config.ts:
Tambahkan terjemahan ke file JSON Anda di src/content/i18n/.
Ini adalah default Bahasa Inggris yang digunakan oleh DocSearch: