手把手教你使用issue作为博客评论系统

自从上周在阮一峰的 每周分享第 60 期 看到了可以将 GitHub 的 issue 当作评论系统,插入第三方网页的 JS 库——utterances。我就对此“魂牵梦绕”。个人博客使用的是VuePress。

TLDR (不多废话,先看效果)

之前是使用了 Valine 作为博客的评论系统。

手把手教你使用issue作为博客评论系统_第1张图片

下图是改为 utterances 风格。

手把手教你使用issue作为博客评论系统_第2张图片

utterances 介绍及使用

utterances 是基于github issue,拥有多种主题的开源免费小组件。

1.首先我们所需要的 github 存储库必须是公开的,而不是私有的,这样我们的读者才可以查看以及发表评论。

2.我们必须在 github 上进行安装 utterances,首先我们访问 utterances应用程序 然后点击 Install 按钮进行安装。
手把手教你使用issue作为博客评论系统_第3张图片

3.在这里可以选择可以关联的存储库,可以选择我们所拥有的库(也包括未来建立的库)或者某一个仓库,这里我们只选择某一个需要进行评论的库,这样比较好。

手把手教你使用issue作为博客评论系统_第4张图片

4.安装完成即可,随后我们访问utterances应用程序就不再是安装而是是执行配置项目。

手把手教你使用issue作为博客评论系统_第5张图片

手把手教你使用issue作为博客评论系统_第6张图片

5.此时服务端配置已经完成,现在我们可以进行客户端的操作,也就是 blog 端。在blog端我们只需要添加以下这段脚本就可以直接运行。

6.因为我的博客是采用 VuePress,所以在 markdown 中是无法使用 script 脚本的。我们就需要编写写一个 vue 组件。(组件的文件路径为 [blog name]/.vuepress/components/)

// Utterances 组件

7.最后。在 md 文档中直接使用上面编写的组件

## 参考资料
[高性能JS-DOM](https://www.cnblogs.com/libin-1/p/6376026.html)   
[imba 性能篇](http://imba.io/guides/advanced/performance)

// 可以在 md 文档中直接使用组件

utterances其他配置项

主题 Theme 选项如下,我们可以选择各色主题:

  • Github Light
  • Github Dark
  • Github Dark Orange
  • Icy Dark
  • Dark Blue
  • Photon Dark

评论 issue-term 映射配置选项如下:

  • pathname
  • url
  • title
  • og:title
  • issue-number

issue-term="1"
特定number的issue,不会自动创建,个人使用该方案

  • specific-term

鼓励一下

如果你觉得这篇文章不错,希望可以给与我一些鼓励,在我的 github 博客下帮忙 star 一下。
博客地址

参考文档

utteranc 文档
博客使用 utterances 作为评论系统

你可能感兴趣的:(工具软件)