跳转至

Computer Science

基于 giscus 为网站添加评论系统

giscus 是一个简单易用的评论系统，它使用 GitHub Discussions 的作为存储和管理评论的后端。网站的访客可以使用 GitHub 账号登录并发表评论，当有新评论时 GitHub 还会用邮件通知网站的主人。

本文记录了基于 giscus 为网站添加评论系统的过程。整个过程还算比较顺利，但中途遇到的关于一键配置多个页面展示评论系统的问题也困扰了我很久。将其记录于此，希望能帮助自己和他人。

image-20230722131239896

Typora 设置默认代码语言

在 Typora 中可以插入代码块，但每次都需要手动添加语言。若经常需要插入同一种语言的代码块，可以借助第三方的快捷键工具 AutoHotkey，自动设置代码块的语言，提高工作效率。

VS Code 加载 Web 视图时出错的解决方案

报错原因

在保存一个大型jupyter notebook文件时，自己突然关闭了标签页。再打开它时，VS Code 就报错：

Text Only
加载 Web 视图时出错: Error: Could not register service workers: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state..

image-20230203004334063

并且也不能打开其他任何jupyter notebook文件，推测是 VS Code 程序出了问题。

解决方案

我自己曾经遇到过两次这个报错，第一次是在个人电脑 Windows 系统上，第二次是在 Linux 服务器上。下面分别介绍针对这两个系统的解决方案。

中文技术文档的写作规范

本文转载了阮一峰的《中文技术文档的写作规范》。

本站之前发布的文章有许多并没有遵循这一规范（例如中英文之间应有空格）。在今后的工作和写作中，我会尽量书写规范的文档，提高文章的易读性。