使用giscus为org-mode的Hugo博客文章建立评论区

Sun, 27 Aug 2023 13:23:50 +0800

本文是基于个人从零实践经验，
简要介绍了笔者是如何使用giscus工具为本站中 .md .org 格式的文章挂载评论区。

This post is also available in: English

使用giscus为org-mode的Hugo博客文章建立评论区

1. giscus简介

giscus，一款基于Github Discussions的评论区系统，它与另一款基于Github Issues的评论区系统utterances极为神似。

giscus的作者laymonage (Sage Abdullahe)在其博客的Introducing giscus一文中提到：

Ta也曾是utterances的用户，直到Github推出discussions功能时，使用discussions替代issues作为评论区系统后端的想法应运而生。

Github方面在推出discussions时也曾这样说过：

"Until now, GitHub only offered issues and pull requests as places to have these conversations. But issues and pull requests both have a linear format—well suited for merging code, but not for creating a community knowledge base. Conversations need their own place —that’s what GitHub Discussions is for."

Hugo+Vercel建立个人博客

Sat, 26 Aug 2023 02:56:54 +0800

本文主要记录了我个人从零建站的主要过程，并不会事无巨细地记叙。
旨在为拥有类似需求的朋友提供使用Hugo+Vercel建站的参考。

This post is also available in: English

Hugo+Vercel建立个人博客

1. 静态网站生成工具

静态网站生成工具，它可以帮助个人博主将使用Markdown等标记语言写好的文章，以尽量便捷省心的方式生成静态网站。

关于 “如何选择一款适合自己的静态网站生成工具” 这一话题在知乎等论坛早已有过不少专业的对比讨论，这里就不再班门弄斧、重造轮子。

我选用Hugo的主要原因是 “Hugo原生支持.org文件” 。
这对于习惯使用Emacs及其org-mode的我来说是一项很重要的特性。

在Hugo官网有相当详细的快速上手文档，其过程主要为以下六步：

安装Hugo

安装Git

创建网站

设定主题

创建文章

生成静态网站并运行

下面将简要记录我的建站过程。

1.1 安装Hugo和Git

在我个人常用的Windows11环境下，我习惯于尽可能地使用微软官方提供的包管理器 winget 来安装开源软件：

打开PowerShell并输入：
winget install Hugo.Hugo.Extended Git.Git
静待安装完成。
（当然，也可以使用cmd来进行上述及后续步骤）

这一步根据网络情况耗时不定，如果觉得 winget 太慢当然也可以根据Hugo官方文档：prebuild的内容下载压缩包并配置系统环境变量。（个人不喜欢这种不便于管理的方式）

安装完成后，在PowerShell中输入
hugo version
若显示类似如下字段，则说明Hugo安装成功。

hugo v0.117.0-b2f0696cad918fb61420a6aff173eb36662b406e+extended windows/amd64 BuildDate=2023-08-07T12:49:48Z VendorInfo=gohugoio

同样方式验证Git的安装
git version
显示类似如下字段，则说明Git安装成功。

git version 2.38.1.windows.1

1.2 创建网站

使用资源管理器创建好用来存放网站的 Mysite 文件夹后，进入该文件夹并在空白处右键选择 Open in Terminal / 在终端中打开 。
（当然你也可以直接在cmd或powershell中使用 cd 指令索引到这个文件夹内）

文章 on 莱姆狼🐺的小窝

使用giscus为org-mode的Hugo博客文章建立评论区