Comentários nos artigos
   2 min leitura

De início não estava a pensar em permitir comentários, mas como o ser humano é um animal social, fui ver se podia configurar um sistema sem ter de inventar muito.
De início considerei o Disq.us, que vem do origem com o Hugo, mas tem muitas desvantagens.
O Zdoc tem pré-configurado o Utteranc.es, que tem as vantagens de exigir um registo GitHub (gente que se porta bem, espero eu) e de ficar num repo.
Criei um repo público só para os comentários e instalei a app Utteranc.es no repo.

Configuração

Bastou ir ao config/params.toml, ligar o sistema de comentários e configurar as credenciais:

1
2
3
4
5
enableComment = true

[utterances]       # https://utteranc.es/
  owner = "<GitHub Username>"              # Your GitHub ID
  repo = "<utteranc.es repo name>"               # The repo to store comments

E o Zdoc acrescenta automaticamente um campo de comentários no final dos artigos.

Blog

Mas nos posts do Blog, não. Para isso, é necessaário editar manualmente o partial, acrescentando {{ partial "comments/comments.html" . }} na secção correcta:

1
2
3
4
5
6
7
8
9

<article id="list-main" class="{{ if $wideViewAsDefault }}lm{{ else }}m{{ end }}" data-dir="{{ $.Param "languagedir" | default "ltr" }}">
      {{ if $.Param "enableBlogBreadcrumb" }}
        {{ partial "main/component/breadcrumb.html" . }}
      {{ end }}
      {{ partial "main/sections/list-main.html" . }}
      {{ partial "main/component/pagination-single.html" . }}
      {{ partial "comments/comments.html" . }}
    </article>

E já está.
Infelizmente, como se baseia em GitHub Issues e não em GitHub Discussions não há pré-moderação. Por isso portem-se bem.

Neste artigo