跳转至

MaterialX 接入 Giscus 评论系统

Giscus 是一个基于 GitHub Discussions 的轻量级评论系统。它让你可以在静态网站(如博客、文档站)中嵌入评论区,而所有评论数据实际上都存储在你指定的 GitHub 仓库的讨论区里。

这里记录一下个人的 MkDocs(基于 MaterialX 主题)站点,在集成 giscus 评论的同时,并让它使用 data-mapping="number" 精确与指定的 Discussion 一一匹配对应。核心思路是:覆盖主题的 comments.html 模板,在页面 front matter 中为每篇文章手动指定一个 GitHub Discussion 编号,然后让 giscus 脚本动态读取这个编号作为 data-term。

少无适俗韵,性本爱丘山

上学的时候读陶渊明的《归园田居·其一》,懵懵懂懂,记忆犹新的只有五柳先生对官场束缚的厌恶,对他归隐后的田园自由的向往与自得,却难以共情,没法真正体会。

人到中年,再读到这首诗,感慨良多,更能唤起自己内心对平静自由生活向往的共鸣。

基于 GitHub Discussions 的 Repozine 极简主题

放在 GitHub 的博文有一两周的时间没有更新了,工作带来的煎熬,业务方向的调整,让整个人对技术忽然就失去了焦点,AI 的环境困局里越来越有种学不动的无力。心力交瘁的时候,就开始想着对自己的博客站点来点不一样的调整。

MkDocs 主题看久了有点审美疲劳,东一篇西一篇的博文有点撑不起 Category 分明的文档站点,好像有点杀鸡用牛刀的感觉。

我的第二大脑 AtomGit

我其实在 2023 年 12 月很早就注册了 gitcode 的账号,那时候 GitCode 和 ATomGit 还是两个互不相通的独立平台。

之所以关注和使用 GitCode,主要原因在于它同时集成了 Issues 和 Discussions,这应该是国内第一个也只截止目前为止唯一一个同时集成这两大功能的开源平台。第二个原因,是对 gitee 半死不活和 Issues 不支持全文搜索(虽然现在已经支持)的死心,以及对极狐高昂付费的退缩,虽然后面腾讯又出了一个 CNB 但仅支持微信扫码,不支持账密登录又成功把我劝退。

爬广州增城第一峰有感

爬山的经历自己见怪不怪了,这一次的牛牯嶂小环线却有着一些不一样的体验。

这是一次真正意义的临时起意说走就走的徒步。前一天从讨论到约车,第二天早晨 6:00 出发,一切都有点不可思议。在自己的记忆力里,两个人尤其是两个大男人爬山甚至是徒步的经历基本上为零。

八仙

知道《八仙》这部电影,主要源于每天上下班都在听的珠江经济台《珠江第一线》(朝朝饮早茶)主持人李嘉的安利。本来想着周末刚好有空去看沈腾的《欢迎来龙餐馆》,但是孩子又想着看自己喜欢的,权衡一下就只剩下《八仙》了,于是就安排上了。

公众号改名字

公众号想改名字的想法总会时不时在脑海蹦跶,IT 的这个绑定总有点不合时宜的局促感,有被当下无处不在的 AI 技术冲击带来的一些焦虑,也有对自己职业方向的一些思考。爱好者其实并非内心的一个真实反馈,只不过有些事情做多久而久之就形成了一种本能。

又一方面想着不要改太多,要克制一点,所以一直迟迟没下定决心,更大的原因应该还是一些想到的名字都已经名花有主。

从华为到 OPPO

不知不觉手上的 mate 30 Pro(4G)8+256 手机从入手到今天,已经用了整整 5 年。这也算得上是第一款真真正正可以从时间上算清楚的使用时长的高端旗舰了,虽然在这之前也用过好几年的 iphone 6s —— 这才是真正意义上人生的第一款高端机,也是大学毕业后用自己的工资在香港买的第一台高端旗舰手机。

天斧 88DP 剁手记

2026 年的 6.18 表面波澜不惊,内心却蠢蠢欲动 —— 电子设备太贵折腾不起,高端羽毛球拍的心 AK 都压不住。

五一琐记之徒步、羽球与闲欢

2026 年的五一假期,期待了好久,对于去哪里一直缺少规划。但是历历在目的反而是在期待这个假期的那些日子,尤其是节前的最后一两周,印象深刻,完美阐释了期待的过程往往比享受结果本身更让人感到幸福。

今天是星期三,5 天假期转眼即逝,回来上班的第一天,回味一下这个期待已久的五一假期 1311 之旅 —— 一次徒步,三场羽毛球,一次游乐场,一次星巴克。