Gitalk 是一个使用 Preact 制作,基于 github issues 的评论插件。

在当前的主题下使用了 Gitalk 配置简单, 精简的功能,目前感觉不错。

Config

这里讲下在 当前主题的下的 Gitalk 的配置和使用。在个人项目的配置使用,就参考官方吧,有中文文档。

1
2
3
4
5
6
7
gitalk:
apply: true
clientID: you app clientID
clientSecret: you app clientSecret
repo: project name
owner: you github name
admin: you github name and other admin github name

apply: 仅为 true 或 false, 这里默认使用评论 Gitalk, 所以是 true
clientID: 这是 github app 的 ID
clientSecret: 这是 github app 的 Secret
repo: 为你的项目名称
owner: 项目作者(也就是你 github 的用户名)
admin: 这里是管理员,是一个集合

申请 Github App

  • Application name: 这里是项目名称(仅仅是个名字)
  • Homepage URL: 这是你网站域名(例如:http://hehehai.cn
  • Applocation description: 项目说明
  • Authorization callback URL: 认证后的重定向地址(例如:http://hehehai.cn

这里重定向我没去研究,应该可以使用其他的方式定向到认证前点击登录的页面。参考 Github OAuth Api

申请后,你有可以看到你的项目了,项目有两个关键的东西。

  • Client ID: 你的项目ID
  • Client Secret: 认证密匙

这里就配置上面的主题配置文件就行了。

后面的repo举个例子: https://github.com/hehehai/blog

1
2
repo: blog
owner: hehehai

这里 API 就会找到 hehehaiblog 项目的 issues 来存储评论。

Use

因为是 preact 制作的,所以 js 文件就有 127kb,有些大。当前主题使用了 CDN,缓存的情况下可以接受。

主题没有在首页使用 gitalk, 不会影响首页的加载,而在文章页使用了 gitalk,而 gitalk 第一次在当前文章页使用的情况下,会在项目 issues 创建信息,所以会慢些,之后就很快了。

Reference