Giscus

[cmolisee]

Checklist

• I have read and accepted the contributing guidelines.

Description

Love this theme. works great. Trying to configure giscus. I've filled out the info in _config but I am still not seeing comments on my posts or pages. Is there something in the html or markdown i need to include? do i need to add the giscus app to my repo? I've tried both with and without giscus app on the repo.

the repo is public and discussions is enabled. Not sure what I am missing?

[lakshyaelite]

Convert <script> tag to the _config.yml values

You can convert the <script> tag generated by https://giscus.app into a YAML config block for your Jekyll site like this, but first ensure your GitHub repository is properly set up.

1. Configure Your GitHub Repo for Giscus

It seems like you don't have the Giscus app installed so before adding anything to _config.yml, do the following:

1. Ensure your GitHub repository is public.

2. Go to Repository → Settings → Features and enable Discussions.

3. Install the Giscus GitHub App:

   • Choose "Only select repositories"
   • Select your blog repository (https://github.com/cmolisee/cmolisee.github.io)
   • Approve the requested permissions

2. Giscus Script Example from Giscus.app

Note

This example is for my blog. You can refer to the mapping table I have provided below.

<script src="https://giscus.app/client.js"
        data-repo="lakshyagithub/lakshyagithub.github.io"
        data-repo-id="R_kgDOOxyq-w"
        data-category="General"
        data-category-id="DIC_kwDOOxyq-84CqskJ"
        data-mapping="pathname"
        data-strict="0"
        data-reactions-enabled="1"
        data-emit-metadata="0"
        data-input-position="bottom"
        data-theme="preferred_color_scheme"
        data-lang="en"
        crossorigin="anonymous"
        async>
</script>

3. Converted _config.yml Block

giscus:
  repo: lakshyagithub/lakshyagithub.github.io
  repo_id: R_kgDOOxyq-w
  category: General
  category_id: DIC_kwDOOxyq-84CqskJ
  mapping: pathname
  strict: 0
  input_position: bottom
  lang: en
  reactions_enabled: 1

4. Mapping Reference Table

Giscus <script> Attribute	_config.yml Key	Value
data-repo	repo	lakshyagithub/lakshyagithub.github.io
data-repo-id	repo_id	R_kgDOOxyq-w
data-category	category	General
data-category-id	category_id	DIC_kwDOOxyq-84CqskJ
data-mapping	mapping	pathname
data-strict	strict	0
data-input-position	input_position	bottom
data-lang	lang	en
data-reactions-enabled	reactions_enabled	1

5. Enable Comments on Posts

In each post or page where you want Giscus to appear, add this to the front matter:

comments: true

Notes

• You can leave out emit-metadata, theme, crossorigin, and async as they are handled internally by the theme.
• Be sure your post layout includes {% include comments.html %} (already present in most themes like Chirpy).