2024-08-03 本站改动:使用 Yue 主题和 giscus 评论,post 目录改为 posts

💡 原文中文,约7300字,阅读约需18分钟。
📝

内容提要

本文列举了本站于2024年7月28日至2024年08月03日的改动,包括清理无用文件、更换主题、修改评论服务、删除相关文件、修订自述文件和package.json等。文章还提到了将主题换为Yue、安装主题、写新配置、构建网站等步骤。最后还介绍了将评论服务从utterances改为giscus的过程,并提到了重命名post文件夹为posts的操作。

🔎

延伸解读

主题更换与构建效率提升

文章提到,更换为 Yue 主题后,网站构建的目录和文件数量明显减少,构建时间从 750ms 降至 450ms。这主要是因为新主题编译时少生成了无用页码,同时暂时关闭了 enableGitInfo 并移除了统计和评论脚本。对于关注网站性能的读者,主题选择对构建效率有直接影响,但需注意构建时间的变化也可能与其他配置调整有关。

评论系统迁移的注意事项

从 utterances 迁移到 giscus 后,评论支持回复功能,且由 GitHub Discussions 驱动。迁移过程中,作者将 issue 转换为 discussion,并手动调整了标题中的路径。需要注意的是,迁移前应关闭评论以避免读者留言干扰,同时要确保域名限制等配置正确。对于使用类似评论系统的站点,迁移时需仔细处理旧评论的映射和链接更新。

URL 结构变更与重定向策略

将 post 文件夹改为 posts 后,所有文章链接的路径都发生了变化。作者通过 Cloudflare Pages 设置了 308 重定向,将旧链接永久指向新地址,并手动修改了文章内的内部链接。这一过程提醒我们,更改 URL 结构时,必须同步更新内部链接、设置重定向,并迁移评论,否则可能导致读者访问失效或评论丢失。

❓

Q&A

本站在2024年进行了哪些主要改动?

本站在2024年进行了清理无用文件、使用Yue主题、将评论服务从utterances改为giscus、重命名post文件夹为posts等改动。

为什么将评论服务从utterances改为giscus?

giscus支持多语言和回复评论,功能比utterances更强大。

如何将post文件夹改名为posts?

需要重命名文件夹并修改相关配置文件,以确保网站链接的正确性。

新主题Yue的安装过程是怎样的?

安装Yue主题包括添加主题的Git子模块、写新配置并删除旧配置。

更换主题后网站的构建效率有何变化?

新主题编译的网站减少了无用的页码,构建时间从750ms减少到450ms,提升了构建效率。

在迁移评论时需要注意哪些事项?

迁移评论时需确保旧链接的重定向、修改文章内链接,并检查评论是否成功迁移。

➡️

继续阅读