PrimeEdge 主题教程

评论系统

配置评论系统（Twikoo / Waline）

评论系统

PrimeEdge 支持两种评论系统：Twikoo 和 Waline，通过 provider 参数切换。

选择评论系统

在 config.toml 中设置使用哪个评论系统：

[params.comments]
  provider = "waline"  # 可选: "twikoo" 或 "waline"

Waline 配置

Waline 是一款简洁、安全的评论系统，支持多种数据库后端。

部署 Waline 服务端

参考 Waline 官方文档 部署服务端，支持 Vercel、Railway、Docker 等多种方式。

配置参数

[params.waline]
  enable = true
  serverURL = "https://your-waline-server.com"
  # lang = "zh-CN"       # 界面语言
  # dark = "auto"        # 深色模式：auto, true, false
  # reaction = false     # 文章表情反应
  # pageview = false     # 阅读量统计
参数必填默认值说明
enable是false是否启用
serverURL是-Waline 服务端地址
lang否zh-CN界面语言
dark否auto深色模式适配
reaction否false文章表情反应
pageview否false阅读量统计

Twikoo 配置

Twikoo 是基于腾讯云开发或 Vercel 的评论系统。

部署 Twikoo

参考 Twikoo 官方文档 部署，支持：

  • 腾讯云云开发（免费额度）
  • Vercel 私有化部署

配置参数

[params.twikoo]
  enable = true
  envId = "https://your-twikoo-url.com"
  version = "1.7.3"
  # region = "ap-shanghai"  # 腾讯云部署时需要
  # lang = "zh-CN"
参数必填默认值说明
enable是false是否启用
envId是-Twikoo 环境 ID 或服务端 URL
version否1.7.3Twikoo CDN 版本
region否-腾讯云区域（如 ap-shanghai）
lang否zh-CN语言

评论显示位置

评论系统默认显示在：

  • 文章页面（posts）
  • 普通页面（pages）
  • 笔记页面（notes）
  • 好物详情页（good-things）

不显示在：

  • 首页
  • 列表页
  • 归档页
  • 搜索页

关闭特定页面评论

在文章 Front Matter 中设置：

---
title: "某篇文章"
comments: false
---

邮件通知

两种评论系统均支持邮件通知：

  • Waline: 在服务端配置环境变量 SMTP_SERVICE、SMTP_USER、SMTP_PASS 等
  • Twikoo: 在管理后台 → 设置 → 邮件通知中配置

故障排查

评论加载失败

  1. 检查 provider 设置是否正确
  2. 检查对应评论系统的 enable 是否为 true
  3. 检查服务端地址是否可访问
  4. 查看浏览器控制台错误信息

深色模式下评论样式异常

确保 Waline 配置了 dark = "auto"，主题会自动适配深浅色模式。

下一步

评论

0%