在“如何使用 Jekyll 和 GitHub Pages 搭建个人博客”中介绍了基础建站流程,本文继续使用 Utterances 为静态博客增加评论功能。
因为是静态博客,讲道理是没有评论这种动态功能的,但只要思想不滑坡办法总比困难多。utterances就是一个利用Github的issue功能来在静态博客里面实现评论的项目。
_github的issue功能还挺多,不光可以用来issue,还有大佬用来写 [博客](https://github.com/rainzhaojy/blogs/issues/1) [博客](https://github.com/yihong0618/gitblog/issues)_1. 安装 Utterances
打开 Utterances GitHub App,将应用安装到博客对应的仓库,并授予 Issues 读写权限。
2. 修改模板配置
最开始尝试使用gitalk来实现评论功能,搞了半天没整明白,结果翻博客模板的文件的时候看见了一个extensions文件夹,里面直接放了三个评论实现方式,分别是disqus、gitment、utterances, 要不说这模板好呢,作者早就整好了。随便了解了一下这几种方式,选了utterances,说是方便简单无广告。
直接去配置文件_config.yml里面找到这几行并取消注释,把repo按onwer/repo的格式改成自己的,提交代码就好了。
utterances:
repo: "611de/611de.github.io"
issue_term: "title"
label: "utterances comment"
theme: "github-light"
follow_site_theme: true
重新部署后,打开任意文章并滚动到底部,即可看到评论区域。
3. 验证与排错
- 确认目标仓库已启用 Issues。
- 确认 Utterances App 已获得该仓库权限。
- 检查
repo是否严格使用owner/repository格式。 - 如果主题跟随失败,检查
follow_site_theme和浏览器控制台。
4. 总结
YAT 主题已经提供 Utterances 集成,只需完成 GitHub App 授权并填写仓库配置。感谢主题作者 Jeffrey Tse。