Open Source

Memasang Komentar GitHub di Blog Astro dengan Giscus

Panduan menambahkan komentar Giscus berbasis GitHub Discussions ke halaman artikel Astro tanpa membuat sistem login atau database sendiri.

KKXID Editorial··2 menit baca
Ilustrasi sampul artikel Memasang Komentar GitHub di Blog Astro dengan Giscus dengan desain teknologi KKXID
On This Page — Daftar Isi

Memasang Komentar GitHub di Blog Astro dengan Giscus

Bagian komentar bisa membuat sebuah blog terasa lebih hidup. Pembaca bisa menambahkan pengalaman, bertanya ketika langkah tutorial tidak jelas, atau membantu menemukan kesalahan. Tetapi membangun sistem akun dan moderasi sendiri sering terlalu berat untuk blog yang dikelola satu orang.

Giscus menawarkan pendekatan berbeda: komentar disimpan melalui GitHub Discussions dan pembaca menggunakan akun GitHub untuk ikut berdiskusi.

Kenapa menggunakan GitHub Discussions?

Keuntungan utamanya adalah kita tidak perlu menyimpan password pengunjung. GitHub menangani autentikasi, sementara diskusi bisa dimoderasi langsung dari repository.

Konsekuensinya, pembaca yang tidak memiliki atau tidak ingin memakai akun GitHub tidak dapat ikut berkomentar melalui metode ini. Untuk blog yang pembacanya akrab dengan teknologi, batasan tersebut mungkin dapat diterima.

Persiapan repository

Gunakan repository GitHub publik untuk diskusi. Aktifkan fitur Discussions pada pengaturan repository dan buat kategori yang akan digunakan, misalnya Announcements.

Kemudian buka giscus.app dan masukkan nama repository. Situs konfigurasi tersebut akan membantu memperoleh repository ID dan category ID yang diperlukan. Jangan menebak dua nilai itu, karena hasilnya bisa membuat widget gagal terhubung.

Menyematkan komentar di artikel

Giscus menyediakan script embedding dengan beberapa atribut penting: repository, kategori diskusi, bahasa, tema, dan mapping untuk mencocokkan artikel dengan thread.

Untuk blog statis, mapping pathname adalah pilihan yang cukup jelas. Contohnya, halaman /blog/panduan-git/ berhubungan dengan thread untuk path tersebut. Karena itu, usahakan slug artikel tidak sering berubah setelah komentar mulai terkumpul.

Tempatkan widget setelah isi artikel dan referensi, sebelum footer situs. Pengunjung yang tidak ingin berkomentar tidak perlu terganggu saat membaca paragraf utama.

Mode gelap dan performa

Jika blog mendukung dark mode, tema widget sebaiknya mengikuti tema halaman. Beberapa konfigurasi Giscus dapat diubah melalui mekanisme pesan dari halaman induk ke iframe yang disediakan.

Karena Giscus memakai script pihak ketiga, periksa ulang Content Security Policy (CSP), loading, dan kebijakan privasi. Widget yang gagal memuat tidak boleh menyebabkan seluruh artikel ikut rusak.

Moderasi tetap pekerjaan manusia

Akun GitHub bukan jaminan komentar selalu berkualitas. Tetapkan aturan sederhana: tidak menyerang orang lain, tidak membagikan credential, dan tetap membahas topik. Ketika ada komentar spam atau menyesatkan, moderator harus menanganinya.

Cek diskusi secara berkala, terutama untuk artikel teknis yang berisi perintah sistem. Kadang masukan pembaca justru menunjukkan instruksi yang perlu diperbarui.

Giscus tidak membuat blog menjadi jaringan sosial besar. Namun ia cukup memberi tempat diskusi yang wajar tanpa memaksa satu pengelola merawat server komentar dan database tambahan.

Bacaan dan sumber lanjutan

Artikel terkait

Diskusi & komentar

Komentar menggunakan GitHub Discussions. Untuk menulis komentar, masuk menggunakan akun GitHub kamu. Jaga diskusi tetap sopan dan sesuai topik.

Komentar melalui GitHub sedang disiapkan. Diskusi akan tersedia setelah repositori GitHub Discussions dihubungkan.