参考教程:
给你的Hexo-Butterfly添加Giscus评论系统
静态说说功能添加#1290

温馨提示:可能需要魔法

起初

有天在翻阅Butterfly 文檔(六) 时,发现作者有两款可以适配第三方说说功能的插件hexo-butterfly-artitalk以及hexo-butterfly-hpptalk

先说Artitalk说说

artitalk的使用文档中也说明需要使用LeanCloud,而LeanCloud将于2027年1月12日停止服务,且2026 年1月12日起停止新用户注册以及创建新的应用,而我恰好在没看公告的前提(其实是看了公告才知道2026 年1月12日后不能创建新应用)下删除了我最后一个用于测试用创建的应用,亲手葬送了我最后一年使用artitalk的机会(我是申必),只好看向hexoplusplus説説

再说Hexoplusplus说说

我太菜了,虽然hexoplusplus的快速上手文档里面已经写得很明白了,但是cloudflare的界面已经更新换代,发现根本找不到有些界面,折腾许久后,遂放弃了(以后心血来潮了再试试)

使用Giscus评论作为说说

参考教程里面大佬写得很详细了,这里我说说我踩的坑吧

注意butterfly主题配置参数

先放一段我们使用Giscus生成的配置参数,部分内容在配置时已经填好了

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<script src="https://giscus.app/client.js"
data-repo="你的GitHub用户名 + / + 安装了Giscus的仓库的名称"
data-repo-id="输入你的仓库后会自动生成"
data-category="Announcements"
data-category-id="这个也是自动生成"
data-mapping="url"
data-strict="0"
data-reactions-enabled="1"
data-emit-metadata="0"
data-input-position="top"
data-theme="preferred_color_scheme"
data-lang="zh-CN"
data-loading="lazy"
crossorigin="anonymous"
async>
</script>

再放butterfly主题配置文件对应的Giscus评论部分

1
2
3
4
5
6
7
8
9
10
11
12
giscus:
repo: # 对应填入data-repo=后的内容
repo_id: # 对应填入data-repo-id=后的内容
category_id: # 对应填入data-category-id=后的内容
light_theme: light
dark_theme: dark
js: # 这个可以不用管,可填可不填
option:
# 这里填的要和Giscus生成的配置参数一样
# 别像我一样以为可以忽略前面的data-
data-input-position: top
data-lang: zh-CN

切记:category_id部分填入的内容对应data-category-id=后的内容,填成data-category的内容的话会加载不出来

如何让评论默认显示最新而不是最早

参考教程:Giscus高级用法指南

Giscus官网中提到,想添加额外配置的话得在Giscus评论所在仓库中新建一个giscus.json,这里我主要是想我打开评论区后默认显示最新的评论,而不是最早(嗯对我懒得点),那只需要在giscus.json文件中添加如下内容

1
2
3
{
"defaultCommentOrder": "newest"
}

运行三件套预览效果

hexo cl; hexo g; hexo s