Unlike Utterances, it’s a little bit complex to configure Giscus, since we have to configure the GitHub repository’s ID and the discussion category’s ID. This article describes how to set up Giscus properly.
Install and Configure Giscus App
Firstly, you’ll need to install and configure GitHub Giscus App for your public repository. Please making sure that your repository can be accessed by Giscus. For example.
Enable GitHub Discussion
The discussion is disabled by default, you should enable it for your repository.
- Navigate to the Settings.
- Switch to the General tab.
- Check the Discussions feature.
Fetch Repository ID and Discussion Category ID
And then get back to the Giscus site, and fill up the form.
- Type your repository on the repository input, i.e.
hbstack/theme. - Select the Discussion Category.
Once done, the data required by Giscus module will be shown under the Enable giscus section.
| Name | Description |
|---|---|
data-repo | Repository name. |
data-repo-id | Repository ID. |
data-category | Discussions category name. |
data-category-id | Discussions category ID. |
