iframe 沙箱里的评论区!Diversity Comments SDK 运行原理与 OAuth 实战

📖 一、前言

前两篇分别讲了 快速上手 与 配置与 API。本篇聊最有意思的部分:SDK 内部如何运转,以及评论区里最容易翻车的环节——OAuth 登录。

读完本篇,你能理解:一份 JS 如何在两个上下文里工作、配置如何跨越 iframe 边界传递、iframe 高度为何能无跳变同步,以及四大 GitHub 系评论系统(Utterances / Giscus / Gitalk / Gitment)的 OAuth 难题是怎么解的。

Read More

从默认值到页面标识解析!Diversity Comments SDK 配置与 API 详解

📖 一、前言

上一篇 《一套 API 集成六大评论系统!Diversity Comments SDK 快速上手》 讲了三步接入。本篇深入两个日常开发离不开的主题:全部配置项(含 SDK 内部的页面标识解析规则)与 API 方法。

文中所有默认值均提取自 SDK 源码的 DEFAULT_CONFIGS(父页面与 iframe 共享同一套默认值,单一来源),无臆造参数。

Read More

一套 API 集成六大评论系统!Diversity Comments SDK 快速上手

📖 一、前言

之前 Huazie 用 8 篇文章 依次介绍了 diversity-plugins 插件家族的核心 hexo-generator-comments 与六大评论插件(Utterances / Gitalk / Giscus / Twikoo / Gitment / Waline)。

不过那套插件方案是 Hexo 专属的。如果你用的是其他博客系统,甚至是纯手写的网站,想要一套”开箱即用”的多评论方案怎么办?

这就是本篇主角 —— Diversity Comments SDK:任意网站只需引入一个 <script>、调用一次 DiversityComments.init(),即可获得功能完整的评论区,随时切换六大评论系统。

Read More

GitHub Issues 轻量评论方案!Hexo Comments Gitment 插件上手指南

📖 一、前言

GitHub Issues 系评论插件的第三位成员登场 —— Gitment。它比 Gitalk 更轻量,同时保留 OAuth 登录与 Markdown 支持。不过在接入前有一个必须知道的坑:它的默认 OAuth 代理已经失效,需要自行部署。本篇 Huazie 会把这个坑讲清楚。

一起来上手 hexo-comments-gitment 吧!

Read More

数据自主可控的免费评论方案!Hexo Comments Twikoo 插件上手指南

📖 一、前言

前面几篇介绍的 Utterances、Gitalk、Giscus 都深度绑定 GitHub 生态,访客评论需要 GitHub 账号。如果你的博客受众更”大众”一些,或者希望评论数据完全自主可控,那么本篇的 Twikoo 会是一个理想选择。

跟着 Huazie 一起上手 hexo-comments-twikoo 吧!

Read More

用 GitHub Discussions 搭建现代化评论区!Hexo Comments Giscus 插件实战

📖 一、前言

前面两篇介绍了基于 GitHub Issues 的 Utterances 与 Gitalk。本篇登场的 Giscus 则更进一步 —— 它基于 GitHub Discussions(讨论区) 实现,是这几款 GitHub 系评论系统中最”现代化”的一员。

跟着 Huazie 一起上手 hexo-comments-giscus 吧!

Read More

把 GitHub Issues 变成评论区!Hexo Comments Utterances 插件上手指南

📖 一、前言

上一篇 《一套配置通吃六大评论系统!深入解读 Hexo Generator Comments 核心插件》 介绍了负责统一评论界面的核心插件。而真正让某一款评论系统”跑起来”的,是与其搭配的独立评论插件。

从本篇开始,Huazie 会逐一带大家上手这些评论插件。首先登场的,是其中最轻量的一员 —— hexo-comments-utterances。

Read More

一套配置通吃六大评论系统!深入解读 Hexo Generator Comments 核心插件

📖 一、前言

之前 Huazie 在 《个人博客支持留言评论,来看看 Hexo Diversity 主题如何实现的!》 一文中,介绍过 Diversity 主题是如何集成多种评论系统的。

当时这套评论能力还”长”在主题里,只有使用 Diversity 主题的朋友才能享受。现在,它已经被抽离成了独立插件 —— hexo-generator-comments,任何 Hexo 主题都能用了!

接下来就跟着 Huazie 一起深入了解这个多评论系统的核心插件。

Read More