1. Gitalk说明
Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件。
Gitalk 的特性:
1、使用 GitHub 登录2、支持多语言 [en, zh-CN, zh-TW, es-ES, fr, ru]3、支持个人或组织4、无干扰模式(设置 distractionFreeMode 为 true 开启)5、快捷键提交评论 (cmd|ctrl + enter)
使用Gitalk需要你做一些提前准备:1、在github上创建一个仓库,Gitalk会把评论放在这个仓库的issues里面。2、在github上申请一个GitHub Application,来让Gitalk有权限操作github上的仓库。
2. 安装使用
2.1 安装
两种方式引入:
1、直接在HTML文件中引入
<link rel=”stylesheet” href=”https://unpkg.com/gitalk/dist/gitalk.css”>
<script src=”https://unpkg.com/gitalk/dist/gitalk.min.js”></script>
建议直接把文件下载后放在项目目录中,这样就可以不再依赖第三方网络了。
2、通过npm安装
npm i –save gitalk
import ‘gitalk/dist/gitalk.css’
import Gitalk from ‘gitalk’
2.2 使用
1、首先需要在html文件中添加一个容器,Gitalk组件会在此处显示
<div id=”gitalk-container”></div>
2、使用下面的JavaScript代码来生成Gitalk评论:
var gitalk = new Gitalk({
clientID: ‘GitHub Application Client ID’,
clientSecret: ‘GitHub Application Client Secret’,
repo: ‘GitHub repo’,
owner: ‘GitHub repo owner’,
admin: [‘GitHub repo owner and collaborators, only these guys can initialize github issues’],
id: location.pathname, // 确保唯一,并且长度小于50
distractionFreeMode: false // 类似Facebook评论框的全屏遮罩效果.
})
gitalk.render(‘gitalk-container’)
里面参数下面会讲解.配置好后,页面最终效果(https://gitalk.github.io/):
3. new Gitalk的参数说明
new Gitalk的参数中有github的仓库信息和GitHub Application信息,所以首先我们创建这两个。
首先你需要在github上创建一个仓库和申请一个GitHub Application。在github上创建一个仓库比较简单这里就不讲解了,下面讲一下如何申请一个GitHub Application
注意:如果你打算在自己网站使用Gitalk,并且这个网站的源码在github的仓库上,那么你也可以直接使用这个仓库,Gitalk只使用仓库的Issues。
3.1 申请一个GitHub Application
参考资料
Gitalk 官网Gitalk中文文档
发表回复