@giscusgiscus

giscus

GitHub Discussions tarafından sağlanan bir yorum sistemi. Ziyaretçilerinizin GitHub üzerinden yorum ve tepki bırakmasını sağlayın! utterances tarafından büyük ölçüde ilham alındı.

Not:
giscus hâlâ aktif olarak geliştiriliyor. GitHub da aktif olarak GitHub Discussions ve API'ını geliştiriyiror. Nitekim, giscus'ın özellikleri zamanla değişebilir veya bozulabilir.

Nasıl çalışır

Giscus yüklendiğinde, GitHub Discussions arama API'ı kullanılarak seçilen bağlantı yöntemi (URL, pathname, <title>, vb.) ile uyuşan tartışma bulunur. Uyumlu tartışma bulunamazsa, giscus bot birisi yorum veya tepki bıraktığında otomatik olarak bir tartışma oluşturur.

Yorum yapmak için, ziyaretçiler giscus uygulamasını kendi adlarına yazmak için GitHub OAuth üzerinden yetkilendirmeli. Alternatif olarak, ziyaretçiler direkt olarak GitHub Discussions üzerinden yorum yapabilirler. Yorumları GitHub üzerinden yönetebilirsiniz.

Yapılandırma

Dil

Giscus'ın görüneceği dili seçin. Dilini bulamıyor musun? Çevirilere katkı sağla.

Depo

Giscus'ın bağlanacağı depoyu seç. Şu kriterlerin karşılandığından emin ol:

  1. Depo herkese açık olmalı, yoksa ziyaretçiler konuşmaları göremez.
  2. Giscus uygulaması kurulu olmalı, yoksa ziyaretçiler yorum yapamaz ve tepki veremez.
  3. Tartışma özelliği deponda etkinleştirilmiş olmalı.

Herkese açık bir GitHub deposu. Konuşmalar bu depoya bağlanacak.

Sayfa ↔️ Tartışma Bağlantısı

Gömülü sayfa ile gömülü tartışmalar arasındaki bağlantı yöntemini seçin.

giscus, ismi sayfanın pathname'ini içeren bir tartışma arayacak.

giscus, ismi sayfanın URL'ini içeren bir tartışma arayacak.

giscus, ismi sayfanın <title> HTML elementinin içeriğini içeren bir tartışma arayacak.

giscus, ismi sayfanın <meta property="og:title"> HTML elementinin içeriğini içeren bir tartışma arayacak.

giscus, ismi belirli bir terim içeren tartışma arayacak.

giscus, belirli bir numaraya sahip tartışma arayacak. Bu seçenek otomatik tartışma oluşumunu desteklemez.

Benzer başlıklara sahip birden fazla tartışma olduğunda GitHub'ın bulanık arama yöntemi nedeniyle yanlış eşleşmelerden kaçının. Daha fazla bilgi için dokümantasyonu inceleyin.

Tartışma Kategorisi

Yeni konuşmaların oluşturulacağı tartışma kategorisini seçin. Önerimiz, Duyuru türündeki bir kategori kullanmanız, böylece tartışmalar sadece yöneticiler ve giscus tarafından oluşturulabilir.

Giscus uyumlu tartışmaları ararken yalnızca bu kategori içinde arama yapacak.

Özellikler

Belirli özelliklerin etkin olup olmayacağını seçin.

Tartışmanın ana iletisi için tepkiler gösterilir.

Tartışma meta verisi belirli periyotlarla ana pencereye (gömülen sayfa) gönderilir. Daha fazla bilgi için dokümantasyonu inceleyin.

Yorum kutusu yorumların üstüne konulur, böylece ziyaretçiler tartışmanın sonuna inmeden yorum bırakabilir

Kullanıcı yorum konteynerinin yanına gelene kadar yorumların yüklenmesi ertelenir. Bu, <iframe> öğesine loading="lazy" eklenerek yapılır.

Tema

Sitenize uygun bir tema seçin. Uygun bir tema bulamıyor musun? Temalara katkı sağla.

Giscus'ı etkinleştir

Yorumların sitenizde görünmesini istediğiniz yerine <script> scriptini ekleyin. Eğer giscus classına sahip bir element bulunursa, yorumlar burada gözükür.

Deponuzu ve/veya kategorinizi yapılandırmadınız. Bu alanların değerleri, siz onları doldurana kadar gösterilmeyecektir.
<script src="https://giscus.app/client.js"
        data-repo="[DEPO İSMİ GİRİN]"
        data-repo-id="[DEPO ID GİRİN]"
        data-category="[KATEGORİ İSMİ GİRİN]"
        data-category-id="[KATEGORİ ID GİRİN]"
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="preferred_color_scheme"
        data-lang="tr"
        crossorigin="anonymous"
        async>
</script>

Konteyner düzenini, gömülen sayfadan .giscus ve .giscus-frame seçicileriyle özelleştirebilirsiniz.

Giscus'ı kullanıyorsanız, GitHub'da yıldız 🌟 vermeyi ve giscus başlığını deponuza eklemeyi düşünün! 🎉

Gelişmiş kullanım

Gelişmiş kullanım rehberini takip ederek ek yapılandırmalar (bkz. belirli kaynaklara izin vermek) ekleyebilirsiniz.

Giscus'ı React, Vue veya Svelte ile kullanmak için giscus bileşen kütüphanesine göz atın.

Geçiş yapma

Önceden GitHub Issues kullanan sistemler kullandıysanız (bkz. utterances, gitalk), bu sorunları tartışmalara çevirebilirsiniz. Çevirdikten sonra, tartışma başlıklarıyla sayfa bağlantılarının doğru olduğundan emin olduktan sonra, giscus otomatik olarak tartışmaları kullanacaktır.

Giscus kullanan siteler

Katkı sağlama

CONTRIBUTING.md yazısını inceleyin

Şimdi deneyin 👇👇👇

Powered by Vercel