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

[imsun]

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

Gitment 包括以下特性：

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

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

• 项目地址
• 示例页面
• 中文简介

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

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

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

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

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

[yangg]

不能自动创建一个 issue 么？

[imsun]

@yangg 不能

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

[loading]

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

[zjqzxc]

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

[imsun]

@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]

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

[mokeyjay]

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

[momocraft]

不错哎，晚点加一个

[EyreFree]

滋瓷，🤓

[gimp]

Cool ~

[imsun]

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

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

[harchiko]

很棒！ 楼主怼得好！

[irainsoft]

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

[Unknwon]

碉堡了。。

[RqPS6rhmP3Nyn3Tm]

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

[lululau]

👍

[nightwind]

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]

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

[rashawn]

很好啊 支持啊

[shyling]

和我博客一样 hhh

[cocoakekeyu]

感觉多了一个授权流程

[mahone3297]

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

[imsun]

@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]

能从 disqus 迁移数据吗

[crispgm]

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

[chunqiuyiyu]

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

[FEDT]

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

[momocraft]

在评论框登录时， 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]

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

很有意思……

[imsun]

@momocraft 这个我也很苦恼。

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

[shower]

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

[Senorsen]

挺有创意的…

[ipconfiger]

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

[Antidictator]

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

[ininit]

挺有创意的，支持

[chunqiuyiyu]

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

[Senorsen]

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

[zsx]

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

[Orzzzz]

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

[ashfinal]

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

[billie]

创意不错，支持～

[mcone]

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

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

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

[Shazoo]

@imsun 蛮好玩的，这个咋和 hexo 结合起来？

[fhefh]

挺好的 先 mark start

[Hstar]

先支持一发, 如果能实现所有用了你这个轮子的网站不用分别授权登陆就好了.

[imsun]

@Shazoo 可以看上面的中文简介。

我的博客就是 hexo 的。稍微改一下博客代码，按中文简介里的步骤引入 Gitment ，然后填好 id 、 title 之类的参数就可以了。

[woostundy]

很棒，支持

[imsun]

@Hstar 正要通过 iframe 实现类似的功能。等下个版本更新会加上。

[junnplus]

@shyling 毕竟是小姐姐

[shyling]

@junnplus hhh

[popu111]

https://github.com/popu125/hyde-pa

随手给某经典 Hugo 主题加上了，回头换上。

[crispgm]

@Orzzzz 功能啊 逻辑啊 当然没毛病 本来就不是关键

假设 V2EX 关了 去 GitHub 建个项目 “ V2EX on GitHub ”
全去 issues 发帖回帖 说不定能建设成 GitHub 上最大论坛

[Rocko]

Nice~

[Rocko]

第二页的评论貌似加载不出

[ruter8]

mark 下，改天给博客替换上去，目前用的是 disqus