Goosequill 评论系统配置参数速查

目录

1. 配置结构
2. Giscus
3. Waline
4. 建议起步配置

Goosequill 目前通过 siteConfig.comments 支持两种评论提供方：

• giscus
• waline

同一时间只应配置其中一种。

配置结构

在 src/config.ts 中设置 comments：

1
comments: {
2
  provider: "giscus" | "waline",
3
}

Giscus

最小示例

1
comments: {
2
  provider: "giscus",
3
  repo: "owner/repo",
4
  repoId: "R_kgDOExample",
5
  category: "Announcements",
6
  categoryId: "DIC_kwDOExample",
7
}

参数

说明

• 在 Goosequill 中，repo、repoId、category、categoryId 是硬性必填项。
• Goosequill 会把 Giscus 的主题与站点的 data-theme 和系统明暗模式保持同步。
• 如果未设置 theme_light 或 theme_dark，会先回退到 theme，再回退到 light 或 dark。

Waline

最小示例

1
comments: {
2
  provider: "waline",
3
  serverURL: "https://your-waline-server.example.com",
4
}

参数

说明

• Goosequill 当前使用 window.location.pathname 作为 Waline 的页面路径标识。
• 站点主题会被转换成 Waline 的 dark 布尔值，并在主题切换时同步更新。
• 除了 provider 之外，serverURL 是唯一硬性必填项。

建议起步配置

如果你只想先跑起来：

• 已经使用 GitHub Discussions，就优先选 Giscus。
• 想自托管后端、希望表单控制更多，就选 Waline。