多说挂了，用 GitHub Issues 来当评论系统吧

V2EX = way to explore

V2EX 是一个关于分享和探索的地方

现在注册

已注册用户请登录

爱意满满的作品展示区。

这是一个创建于 3116 天前的主题，其中的信息可能已经有所发展或是发生改变。

Gitment 是作者实现的一款基于 GitHub Issues 的评论系统。主要面向程序员群体，尤为适合各种静态博客和项目页面。

Gitment 包括以下特性：

在前端直接引入，不需要任何后端代码
使用 GitHub 账号登录
可以在页面进行查看、发送评论，点赞，@ 等操作
可以在 GitHub 进行编辑、删除评论等操作
有完整的 Markdown / GFM 支持
支持代码高亮
基于 GitHub 的通知
易于自定义

作者博客的评论系统已迁移至 Gitment 。对于其他使用 GitHub Pages 的博客来说，这个项目可以让你在一个 repo 里同时解决文章和评论问题。

如果你有什么使用上的问题，请在 GitHub 上开 issue ，不要在示例页面、博客页面或本页面下留言，否则我可能无法及时回复。

第 1 条附言 2017-04-05 12:10:28 +08:00

看到有些人认为这是在滥用 GitHub，所以对这个问题作一下额外说明。

我在开发时也一直有这个疑虑，因此仔细阅读了 GitHub ToS，并在开源前将项目地址、项目描述和项目截图一起发给了 GitHub，询问是否滥用及侵权。GitHub 指出了我之前在界面上侵权的一些地方（已在开源前修正），并对项目本身表示：

We're pleased to see you making use of the tools and resources available on GitHub.

因此可以认为这是被 GitHub 接受的行为。但我还是要提醒大家，请保持克制，切勿滥用。

GitHub

页面

gitment

55 条回复 2017-04-07 08:36:45 +08:00

yangg

2017-04-05 07:29:35 +08:00 via iPhone

不能自动创建一个 issue 么？

imsun

2017-04-05 07:35:22 +08:00

@yangg 不能

因为 Gitment 只会用作者创建的 issue 生成评论，并用 label 作 ID ，以避免他人恶意开相同 issue 。所以需要作者登录后手动点一下页面上的初始化按钮来创建 issue 。

loading

2017-04-05 07:40:31 +08:00 via Android

我们使用 issues 写博客的是不是太有超前了？

zjqzxc

2017-04-05 07:48:28 +08:00

没认真看过 github 的用户协议，不知道这样是不是已经违反用户协议了

imsun

2017-04-05 07:52:58 +08:00

@zjqzxc 这个我在博客（就是那篇[中文简介]( https://imsun.net/posts/gitment-introduction/)）里作了说明。

关于这个问题我读了用户协议，也在开源前向 GitHub 发邮件询问过，他们给的回复是：

> We're pleased to see you making use of the tools and resources available on GitHub.

所以我觉得并没有违反用户协议。

lydasia

2017-04-05 07:58:21 +08:00 via iPhone

很多东西就是这样被中国人玩坏的。

mokeyjay

2017-04-05 08:14:56 +08:00 via Android

@lydasia ？？？外国人用 github 当博客就是创意，中国人用 issue 当评论就是玩坏？

momocraft

2017-04-05 08:15:32 +08:00

不错哎，晚点加一个

EyreFree

2017-04-05 08:18:25 +08:00 via iPhone

滋瓷，

gimp

2017-04-05 08:24:46 +08:00

Cool ~

imsun

2017-04-05 08:26:58 +08:00

@lydasia 你对中国人成见很深嘛。

不过我的确要再提醒大家一遍，请大家保持克制，切勿滥用。

harchiko

2017-04-05 08:31:52 +08:00 via Android

很棒！楼主怼得好！

irainsoft

2017-04-05 09:01:26 +08:00

对于技术主题较多的博客是个挺好的选择

Unknwon

2017-04-05 09:19:57 +08:00

碉堡了。。

RqPS6rhmP3Nyn3Tm

2017-04-05 09:20:41 +08:00 via iPhone

@lydasia 不要把锅都甩给中国人，也不要开地图炮

lululau

2017-04-05 09:42:22 +08:00

nightwind

2017-04-05 09:54:07 +08:00

Error: API rate limit exceeded for 124.205.32.38. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.)

imsun

2017-04-05 10:04:08 +08:00

@nightwind 这是因为 GitHub 对未登录用户访问 API 有频率限制（按访问者 IP 统计）。你点击下面的登录就可以正常访问了。

rashawn

2017-04-05 10:08:35 +08:00 via iPhone

很好啊支持啊

shyling

2017-04-05 10:13:39 +08:00

和我博客一样 hhh

cocoakekeyu

2017-04-05 10:25:25 +08:00

感觉多了一个授权流程

mahone3297

2017-04-05 10:31:02 +08:00

为什么 secret 放在前端是没安全问题的？我还是没看懂。请教下，谁能解答下？给了 client id ， secret ，不就能操作 api 了？
https://github.com/imsun/gitment#about-security

imsun

2017-04-05 10:58:31 +08:00

@mahone3297
一方面 client ID 和 client secret 并不能独立用来访问 API 。在所有 API 中只有 https://developer.github.com/v3/oauth_authorizations/#delete-an-authorization 里最后三个 API 可以凭借 client ID 和 client secret 访问，但这三个 API 同时需要 access token ，因此在本项目中只有用户本身有能力使用这三个 API ，而且不会造成任何不良影响。
另一方面，按照 OAuth 的标准（ https://tools.ietf.org/html/rfc6749#section-4.1 ），只要有 client ID 和 callback URI 就已经可以保证认证过程安全，别人无法通过 client secret 来影响认证过程的安全性，也无法用来获取用户的 token 。

另外在开源前，我也找过几个朋友对这个项目进行了测试（包括整天黑站的那种），目前并没有发现安全问题。如果哪位发现了安全问题，请在项目内提 issue ，非常感谢。

4679kun

2017-04-05 11:18:55 +08:00 via Android

能从 disqus 迁移数据吗

crispgm

2017-04-05 11:48:17 +08:00

我反对。虽然不一定违反什么协议之类， issue 系统的约定就是提问题的，如果当作评论甚至某些人直接当博客用，都是不太科学的。中国人还是外国人这么搞，我都只认为是滥用。

chunqiuyiyu

2017-04-05 12:40:21 +08:00 via iPhone

我觉得也是滥用。本来我想把博客搭建到 github 上，但是转念一想博客上不一定都写技术文章，所以老老实实购买了 vps 。

FEDT

2017-04-05 12:51:10 +08:00 via Android

很不错的样子，找时间换这个试试

momocraft

2017-04-05 13:02:15 +08:00

在评论框登录时， github 的 oauth 要求了好多权限..这些是必要的吗? 有没有可能只要求写 issue 的权限？

> This application will be able to read and write all public repository data. This includes the following:
>
> Code
> Issues
> Pull requests
> Wikis
> Settings
> Webhooks and services
> Deploy keys
>

msg7086

2017-04-05 13:14:21 +08:00

@crispgm
OP: 用 GitHub 做个评论系统吧。
GitHub: 这挺好啊！资辞！
crispgm: 这是滥用！反对！

很有意思……

imsun

2017-04-05 13:17:22 +08:00

@momocraft 这个我也很苦恼。

GitHub 对权限划分的粒度太粗了，并没有为 issue 部分进一步提供更细粒度的权限， public_repo 已经是为了能写 issue 所获取的最弱的权限了。参见： https://developer.github.com/v3/oauth/#scopes

shower

2017-04-05 14:42:32 +08:00

@chunqiuyiyu 谁说 Github Pages 一定要写技术文章了？ Github Pages 的 Usage limits 在 https://help.github.com/articles/what-is-github-pages/ 写的很清楚，除了“暴力，垃圾，淫秽，虚假等”的内容是不被允许的，其他你想写什么都可以。

Senorsen

2017-04-05 15:27:40 +08:00

挺有创意的…

ipconfiger

2017-04-05 15:29:30 +08:00

你都用 github 了, 难道用 Disqus 会死?

Antidictator

2017-04-05 15:39:29 +08:00 via Android

@ipconfiger 如果再加个反代，我觉得会的

ininit

2017-04-05 15:53:08 +08:00 via Android

挺有创意的，支持

chunqiuyiyu

2017-04-05 18:08:34 +08:00 via iPhone

@shower 好吧，我确实没看过这篇使用规范。但是，在上面写非技术文章感觉有些格格不入。

Senorsen

2017-04-05 19:52:19 +08:00 via Android

@ipconfiger Disqus 的主域名在国内受污染，何况楼主造轮子其实不管怎么说，都值得鼓励，写的挺好的…
兄弟你这话说的是不是冲了点儿？

zsx

2017-04-05 20:39:29 +08:00

思考了一下，不太方便把以前的评论数据导出到 GitHub Issue （比如日期），这个大抵需要弄个像 Google Code 那样的 Bot 来弄了

Orzzzz

2017-04-06 00:14:40 +08:00

@crispgm 博客是一个项目，文章就是 PR ，那么评论就是 issue ，你觉着呢？

ashfinal

2017-04-06 03:55:11 +08:00

用 GitHub Issues 来做评论系统这个想法很早就有了，也有了实现。
楼上担心违反什么条款的，肯定是多虑了。 https://github.com/eduardoboucas/staticman

billie

2017-04-06 08:13:16 +08:00 via Android

创意不错，支持～

mcone

2017-04-06 09:01:18 +08:00

说实话关于什么滥用 github 啊违反 TOS 啊之类的评论我倒是不怎么在意

我比较在意的是这个项目的真正实用性建议 github 在国内这种时不时被 x 一下的样子感觉能稳定访问 github 的，应该访问 disqus 没啥问题吧。。。另外我跟楼上某位一样，看了下这个 oath 权限，表示。。。可能需要一个小号去专门发评论？额

不错楼主这个创意蛮不错的赞一个