Comments

This theme has built-in support for comment on the posts. Currently, it support the following comment plugins:

Disqus

Disqus is a popular comment plug-in. After signing up to Disqus you will need to provide your shortname under params.features.comment section of your config.yaml file as below:

params:
  features:
    comment:
      enable: true
      disqus:
        shortName: <your-disqus-shortname>

Valine

Valine appears to be a Chinese comments comments plugin. You can enable valine comment plugin by adding valine section under params.features.comments section as below:

params:
  features:
    comment:
      enable: true
      valine:
        appId: app-id
        appKey: app-key
        avatar: avatar
        placeholder: placeholder
        lang: lang
        recordIP: recordIP
        enableQQ: enableQQ

Utterances

Utterances uses GitHub Issues to store the comments for your posts. This requires you to allow have a public repository, and the Utterances app to use your repository. Setup instructions can be found at the Utterances home page.

params:
  features:
    comment:
      enable: true
      utteranc:
        repo: your-repo/name
        issueTerm: url
        theme: light

Giscus

Giscus is based off Utterances, but uses GitHub Discussions as the backend. This requires you to allow have a public repository, and the Giscus app to use your repository. Setup instructions can be found at the Giscus home page.

To enable Giscus comment plugin, at first go to giscus.app. On the Configuration section, provide the necessary information. It will give you a script to include to your site. You just need to extract the respective information from the script and provide it under params.features.comment.giscus section as below:

params:
  features:
    comment:
      enable: true
      giscus:
        repo: your-repo/name
        repoID: your-repo-id
        category: your-category
        categoryID: your-category-id
        # theme: light
        # map: url
        # reaction: 1
        # metadata: 0
        # inputPosition: bottom
        # crossOrigin: anonymous

The commented out options are optional. You can use them to further customize your comment experience.