在“如何使用 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文件夹,里面直接放了三个评论实现方式,分别是disqusgitmentutterances, 要不说这模板好呢,作者早就整好了。随便了解了一下这几种方式,选了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