Hexo 集成 Gitalk 评论系统

什么是 Gitalk

Gitalk 利用了 GithubAPI 基于 GitHub Issue 和 Preact 开发的评论插件，官方网址： https://gitalk.github.io

Gitalk 特性

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

配置Gitalk

1. 要使用 Gitalk 需要先在 GitHub 上注册新应用，链接：https : //github.com/settings/applications/new

OAuth Apps

2. 点击注册后，页面大致如下，其中Client ID和Client Secret在后面的配置中需要用到，也是应用访问你 Github 的凭证，到时复制粘贴即可：

连接密匙

3. Next 主题 v7.6.0 中已经默认集成了gitalk，只需在\themes\next\_config.yml锁定gitalk配置开启使用：

修改gittalk配置

gitalk:
  enable: true  #启用gitalk
  github_id:   #github帐号 例：CodeHaotian
  id: location.pathname  #此设置参照下文常见问题说明
  repo:   #存放评论的仓库名称
  client_id:   #application的id，即上文Client ID
  client_secret:  #application的密码，即上文Client Secret
  admin_user:  #页面显示联系**初始化评论 例：CodeHaotian
  distraction_free_mode: true # Facebook-like distraction free mode
  # Gitalk's display language depends on user's browser or system environment
  # If you want everyone visiting your site to see a uniform language, you can set a force language value
  # Available values: en | es-ES | fr | ru | zh-CN | zh-TW
  language: zh-CN

4. 重新部署博客，打开页面进入某一博客内容下，评论会出现在页面最下方

常见问题说明

1、未找到相关的issue进行评论，请联系@XXX初始化创建。

未初始化

• 解决办法：出现这总情况是因为博主未给文章评论初始化，博主只需要登录 GitHub 账户即可。

2、浏览器进入开发者模式，看见类似https://api.github.com/user 401 (Unauthorized)

• 解决办法：找到主题配置文件， 在 gitalk 配置里添加 id: location.pathname

3、Error: Not Found.

Error: Not Found

• 解决办法：未能正确找到仓库 repo，检查一下你的仓库是否配置正确

文章具体为 Hexo Next v7.6.0 环境下集成 Gitalk