VuePress EcosystemVuePress Ecosystem
  • Theme Guidelines
  • theme-default
  • Hope Theme
  • Plume Theme
  • Reco Theme
  • Feature Plugins
  • Markdown Plugins
  • Search Plugins
  • Blog Plugins
  • PWA Plugins
  • Analytics Plugins
  • SEO Plugins
  • Development Plugins
  • Tool Plugins
  • AI Plugins
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • Theme Guidelines
  • theme-default
  • Hope Theme
  • Plume Theme
  • Reco Theme
  • Feature Plugins
  • Markdown Plugins
  • Search Plugins
  • Blog Plugins
  • PWA Plugins
  • Analytics Plugins
  • SEO Plugins
  • Development Plugins
  • Tool Plugins
  • AI Plugins
  • @vuepress/helper
  • English
  • 简体中文
GitHub
  • Blog
    • Guide
    • Config
  • Comment
    • Guide
    • Giscus
    • Waline
    • Artalk
    • Twikoo
  • Feed
    • Guide
    • Plugin Config
    • Frontmatter Config
    • Channel Config
    • Feed Getter

Giscus

Giscus is a commenting system based on GitHub Discussion that is easy to start.

Preparation

  1. Create a public repository and open discussion panel as a place to store comments.

  2. Install the Giscus App to have permission to access the corresponding repository.

  3. After completing the above steps, please go to the Giscus page to get your settings.

    You just need to fill in the repository and Discussion categories, then scroll to the "Enable giscus" section at the bottom of the page and obtain four attributes: data-repo, data-repo-id, data-category and data-category-id.

Config

Please set provider: "Giscus" and pass data-repo, data-repo-id, data-category and data-category-id as plugin options as repo, repoId, category categoryId.

For other options, see Giscus Config.

Theme

By default, the theme of Giscus is light or dark (based on darkmode status).

Dark Mode

To let Giscus apply the correct theme, you need to pass a boolean value to <CommentService /> via darkmode property, indicating whether darkmode is currently enabled.

If you want to customize theme in lightmode and darkmode, you can set lightTheme and darkTheme option with a built-in theme keyword or a custom CSS link starting with https://.

Edit this page on GitHub
Last Updated:: 2/17/25, 5:44 AM
Contributors: Mister-Hope
Prev
Guide
Next
Waline