Giscus

Introduction

Par défaut désactivé (comme vous le voyez sur le snippet de code ci-dessous), les commentaires avec giscus peuvent être activés directement dans la configuration hugo.(yaml|toml) :

params:
  hugo_primer:
    giscus:
      disabled: true
      # params:
      #   data-category-id:
      #   data-category:
      #   data-emit-metadata:
      #   data-input-position:
      #   data-loading:
      #   data-mapping:
      #   data-reactions-enabled:
      #   data-repo-id:
      #   data-repo:
      #   data-strict:

Le choix de giscus repose sur sa capacité à fournir le thème jour et nuit en cohérence avec le site GitHub. Aussi car l’authentification est gérée par son application GitHub, ce qui simplifie l’intégration d’un système de commentaires authentifié.

Remplacer giscus

Vous êtes libre d’utiliser votre propre système de commentaire (plus d’information ici) en remplaçant le layout layouts/partials/hugo-primer/comments.html :

<!-- override this layout to replace the comments system content -->

{{ $container := site.Params.hugo_primer.styles.container }}
{{ if not site.Params.hugo_primer.giscus.disabled }}
    <section class="{{ $container }}">
        <hr class="col-12 my-4" aria-hidden="true" />
        <div class="col-12 px-0 mx-auto">
            <div id="giscus" class="giscus"></div>
        </div>
    </section>
{{ end }}

Notez cela dit en complément que ce layout n’est utilisé par défaut que dans _default/single.html.