1. Disqus Hesabı Oluşturma

Öncelikle Disqus üzerinde bir hesap açmalısınız.

  1. Disqus’a kaydolun
  2. “I want to install Disqus on my site” seçeneğini seçin.
  3. Website Name kısmına blog adınızı yazın.
  4. Choose Your Unique Disqus URL kısmında shortname belirleyin (Örnek: ornekblog).
  5. Basic Plan seçeneğini seçin (Ücretsiz).
  6. Platform olarak “Universal Code” seçin.
  7. Disqus kısa adınızı (shortname) not alın. Örn: ornekblog.disqus.com

2. Hugo’da Disqus’u Etkinleştirme

Hugo projenizin ana dizininde yer alan config.yml veya config.toml dosyasını açın.

📝 config.yml için:

disqus:
  enable: true
  shortname: "ornekblog"
params:
  comments: true

📝 config.toml için:

d [ i p s a c q r o u a m s m m S s e h ] n o t r s t n = a m t e r u = e " o r n e k b l o g "

NOT: ornekblog yerine kendi Disqus kısa adınızı (shortname) yazmalısınız.

3. comments.html Dosyasını Düzenleme

Hugo temanızın yorum sistemini desteklediğinden emin olun.

  1. layouts/partials/comments.html dosyasını oluşturun (Eğer yoksa).

  2. İçine şu kodu ekleyin:

< d / i d v i { v c { > l a p s a s r = t " i d a i l s q " u d s i s m q a u r s k . d h o t w m n l " " > . } }

Bu kod, Disqus yorum sistemini yüklemek için ayrı bir disqus.html dosyasını çağıracaktır.

4. disqus.html Dosyasını Oluşturma

Şimdi layouts/partials/ dizininde disqus.html dosyasını oluşturun ve aşağıdaki kodları ekleyin:

< < < d s / n i c s o v r c s i v } ( } r c i p a ; f ) i r d t r u ( p i = > n ) t p " d t t c v s s ( ; > t d i h h t a . . d > i s i i i r s s . L s q s s o r e h ü q u . . n d c t e t u s p p ( A a f s _ a a ) = = t d e _ c g g t n t o e e { d ' r h n . . o h i J r f u i c t b a e i r d u t u d v a g l e m p t . a d n e s e b S " = = t n : ( o c > i t / ' d r < f w f , d y i / u i i o a ) p d n n e s r t . t i c d r n a a ’ v t o = e - p i > i w = k t p o . d b i e e n l w . l m n t o i c o e d k c n r g s C i a d e . t h n t o a d a i l { i w t i m l e o . e s p d ş n l E q ' ( t . o l u , s i h c e s ) r r a m . + ; e e t e c n r f i n o e e ; o t m w k n ( . ' e D < p s m a a a c b t t r e e h h i d ( r n p . ) e a t j ) f m ' s ; = e ) ' " ; ; ; h t t p s : / / d i s q u s . c o m / ? r e f _ n o s c r i p t " > D i s q u s y o r u m l a r ı n ı < / a > g ö r ü n . < / n o s c r i p t >

Önemli:

ornekblog.disqus.com kısmını kendi Disqus shortname’inizle değiştirin.

5. İçerik Dosyalarında Yorumları Etkinleştirme

Yorumları belirli sayfalarda göstermek için content/posts/ altındaki .md dosyalarına şu satırı ekleyin:

c o m m e n t s : t r u e

Örnek içerik dosyası (content/posts/ornek-yazi.md):

t d c i a o t t m l e m e : e : n 2 t " 0 s H 2 : u 5 g - t o 0 r ' 3 u d - e a 0 3 D i s q u s Y o r u m l a r ı "

6. Değişiklikleri Test Etme ve Yayınlama

Yerel Sunucuda Test Etme

Terminalde aşağıdaki komutu çalıştırın:

h u g o s e r v e - d i s a b l e F a s t R e n d e r

Tarayıcıda http://localhost:1313/ adresine gidin.

Yorum kutusunun görünüp görünmediğini kontrol edin.

Canlıya Alma (Deploy)

Eğer yorumlar lokalde (localhost) çalışmıyorsa, Disqus bazı güvenlik nedenleriyle yorumları gizleyebilir. Yorumları görmek için sitenizi canlıya alın:

h u g o - g c - m i n i f y

Siteyi GitHub Pages, Netlify, Vercel veya kendi sunucunuza yükleyin.

Gerçek domain üzerinden yorumları test edin.

7. Olası Sorunlar ve Çözümleri

Sorun Çözüm
Disqus yorumları görünmüyor. config.yml veya config.toml içinde shortname doğru mu kontrol edin.
Disqus yüklenirken hata veriyor. Tarayıcı konsolunu (F12 > Console) açıp hata mesajlarını kontrol edin.
Disqus localhost’ta çalışmıyor. Siteyi canlıya alın ve tekrar deneyin.
Disqus çerçevesi (iframe) yüklenmiyor. Adblocker veya tarayıcı eklentilerini kapatıp tekrar deneyin.

8. Sonuç ve Özet 📝

✅ Disqus hesabı oluşturduk. ✅ config.yml veya config.toml içinde Disqus’u etkinleştirdik. ✅ comments.html ve disqus.html dosyalarını oluşturduk. ✅ Hugo’yu çalıştırarak yorumları test ettik. ✅ Eğer çalışmıyorsa, hataları kontrol edip düzelttik.

Artık Hugo blogunuzda Disqus yorum sistemi aktif! 🚀 Sorularınız varsa Disqus Destek Sayfası: https://help.disqus.com/