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

📖 一、前言

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

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

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

📖 一、前言

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

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

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

📖 一、前言

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

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

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

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

📖 一、前言

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

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

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

📖 一、前言

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

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

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