跳转至

Hexo博客评论系统

Gitalk

Gitalk

Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件,可以使用GitHub账号进行登录。

特性

  • 使用 GitHub 登录
  • 支持多语言 [en, zh-CN, zh-TW, es-ES, fr, ru, de, pl, ko, fa, ja]
  • 支持个人或组织
  • 无干扰模式(设置 distractionFreeMode 为 true 开启)
  • 快捷键提交评论 (cmd|ctrl + enter)

配置[^1]

1. 新建OAuth App

首先进入github,点击右上角头像【Settings】->【Developer settings】->【OAuth Apps】->【New OAuth App】进行基本配置(一定要细心,看清截图中的红字)。

New OAuth App

2. 生成Client IDClient Secret

上面的填写成功之后进入,我们需要的是生成的Client IDClient Secret

Client ID/Client Secret

3. 博客配置

# Gitalk
# 基于 GitHub Issues
# Based on GitHub Issues
# See: https://github.com/gitalk/gitalk#options
gitalk:
  clientID: xxxxxxx
  clientSecret: xxxxxxxxxxxxxx
  repo: uesername.github.io # 留言板内容需要存放的仓库名称
  owner: uesername # 留言板内容需要存放的仓库名称
  admin: ['uesername'] # 管理员用户
  language: zh-CN
  labels: ['Gitalk'] # issue 的标签
  perPage: 10 # 每页展示条数
  pagerDirection: last  # 排序方式是从旧到新(first)还是从新到旧(last)
  distractionFreeMode: false #类似Facebook评论框的全屏遮罩效果.
  createIssueManually: false #如果当前页面没有相应的 isssue ,且登录的用户属于 admin,则会自动创建 issue。如果设置为 true,则显示一个初始化页面,创建 issue 需要点击 init 按钮。
  # createIssueManually: true
  # 默认 proxy 可能会失效,解决方法请见下方链接
  # The default proxy may be invalid, refer to the links for solutions
  # https://github.com/gitalk/gitalk/issues/429
  # https://github.com/Zibri/cloudflare-cors-anywhere
  proxy: https://cors-anywhere.azm.workers.dev/https://github.com/login/oauth/access_token

utterances

utterances

utterances 是基于 GitHub Issue 构建的轻量级评论小部件。 将 GitHub 问题用于博客评论、wiki 页面等!

特性

  • 开源 。 🙌
  • 没有跟踪,没有广告,永远免费。 📡🚫
  • 没有锁定。 所有存储在 GitHub 问题中的数据。 🔓
  • 使用Primer 设计样式 ,这是为 GitHub 提供支持的 css 工具包。 💅
  • 深色主题。 🌟
  • 轻的。 香草打字稿。 没有适用于常绿浏览器的字体下载、JavaScript 框架或 polyfill。 🐦🌲

配置

1. 安装utterances应用[^2]

访问网址 https://github.com/apps/utterances 授权,设置指定仓库即可。

2. 博客配置[^3]

# Utterances
# 基于 GitHub Issues
# Based on GitHub Issues
# See: https://utteranc.es
utterances:
  repo: xiaodongxier/xiaodongxier.github.io #存放评论的issues的仓库名,可以和博客相同,也可以不同。
  issue_term: title #pathname #博客标题(推荐使用这个,因为上面两个涉及到网址,如果网址包含中文,会被转义,不方便看。)
  label: utterances #选择将分配给由话语创建的问题的标签。标签名称区分大小写。该标签必须存在于您的存储库中 - 话语无法附加不存在的标签。标签名称支持表情符号
  theme: github-light  #主题
  theme_dark: github-dark

参考文献

[^1]: hexo博客添加gitalk评论系统 [^2]: hexo+yilia集成utteranc评论系统 [^3]: utteranc官网