天天看点

Gitment

Gitment 是作者imsun实现的一款基于 GitHub Issues 的评论系统。支持在前端直接引入,不需要任何后端代码。可以在页面进行登录、查看、评论、点赞等操作,同时有完整的 Markdown / GFM 和代码高亮支持。尤为适合各种基于 GitHub Pages 的静态博客或项目页面。

本博客评论系统已迁移至 Gitment,参考作者的介绍部署成功,不过这里补充详细点,方便新手入门。

1、注册 OAuth Application

通过地址传送门申请配置,注册一个新的 OAuth Application,其他内容可以随意填写,但要确保填入正确的 callback URL(一般是评论页面对应的域名,如 https://anttutu.github.io)。

Gitment

创建成功后,你会得到一个 client ID 和一个 client secret,这个将被用于之后的用户登录。

Gitment

2、引入 Gitment

将下面的代码添加到你的页面:

<div id="container"></div>
<link rel="stylesheet" href="https://imsun.github.io/gitment/style/default.css">
<script src="https://imsun.github.io/gitment/dist/gitment.browser.js"></script>
<script>
var gitment = new Gitment({
  id: '页面 ID', // 可选。默认为 location.href  比如我本人的就删除了
  owner: '你的 GitHub Name',              //比如我的叫anTtutu
  repo: '存储评论的 repo',                 //比如我的叫anTtutu.github.io
  oauth: {
    client_id: '你的 client ID',          //比如我的828***********
    client_secret: '你的 client secret',  //比如我的49e************************
  },
})
gitment.render('container')
</script>
           

为了灵活,我在_config.yml中配置好全局参数:

Gitment

3、初始化评论

页面发布后,你需要访问页面并使用你的 GitHub 账号登录(请确保你的账号是第二步所填 repo 的 owner),点击初始化按钮。

之后其他用户即可在该页面发表评论

初始化:点击下初始化即可

Gitment

正常:

Gitment
Gitment

异常:通常是repo或者owner配置不对,请细心检测Error:Not Found 图1。还有本地调测会出现callback不对提示Error: Comments Not Initialized 图2

Gitment
Gitment