Utterances-backed discussion blocks configured globally or per page.
webifier.comments registers kind: comments. It renders an Utterances
script block when a GitHub repository is configured. You can configure it
globally through the extension instance, or locally on a comments section.
config:
webifier:
extensions:
site:
uses: webifier.standard
comments:
uses: webifier.comments
repo: owner/repo
issue_term: pathname
issue_label: comments
theme: preferred-color-scheme
discussion:
kind: comments
label: Comments
repo: owner/repo
issue_term: pathname
issue_label: comments
theme: preferred-color-scheme
Keys:
kind: commentsrepo: GitHub repository used by Utterances.issue_term: Utterances issue mapping, commonly pathname.issue_label: label for created issues.theme: Utterances theme, commonly preferred-color-scheme.crossorigin: defaults to anonymous.When repo is configured, the section emits the Utterances client script.
The actual comments UI is loaded by Utterances in the browser. For pages that
should not load third-party comments, omit the section or set a page-specific
configuration without repo.
The block directly below is the live rendered comments renderer. The renderer emits the widget itself, so this explanatory section is where the surrounding label and context live.
For another comment provider, create a new extension with a renderer such as
kind: comments.giscus or override comments with override: true if you
intentionally want to replace the built-in meaning.