博客文章¶
这是来源于 Discussions · shenweiyan.github.io 的博客类文章。
这是来源于 Discussions · shenweiyan.github.io 的博客类文章。
Giscus 是一个基于 GitHub Discussions 的轻量级评论系统。它让你可以在静态网站(如博客、文档站)中嵌入评论区,而所有评论数据实际上都存储在你指定的 GitHub 仓库的讨论区里。
这里记录一下个人的 MkDocs(基于 MaterialX 主题)站点,在集成 giscus 评论的同时,并让它使用 data-mapping="number" 精确与指定的 Discussion 一一匹配对应。核心思路是:覆盖主题的 comments.html 模板,在页面 front matter 中为每篇文章手动指定一个 GitHub Discussion 编号,然后让 giscus 脚本动态读取这个编号作为 data-term。
上学的时候读陶渊明的《归园田居·其一》,懵懵懂懂,记忆犹新的只有五柳先生对官场束缚的厌恶,对他归隐后的田园自由的向往与自得,却难以共情,没法真正体会。
人到中年,再读到这首诗,感慨良多,更能唤起自己内心对平静自由生活向往的共鸣。
放在 GitHub 的博文有一两周的时间没有更新了,工作带来的煎熬,业务方向的调整,让整个人对技术忽然就失去了焦点,AI 的环境困局里越来越有种学不动的无力。心力交瘁的时候,就开始想着对自己的博客站点来点不一样的调整。
MkDocs 主题看久了有点审美疲劳,东一篇西一篇的博文有点撑不起 Category 分明的文档站点,好像有点杀鸡用牛刀的感觉。
我其实在 2023 年 12 月很早就注册了 gitcode 的账号,那时候 GitCode 和 ATomGit 还是两个互不相通的独立平台。
之所以关注和使用 GitCode,主要原因在于它同时集成了 Issues 和 Discussions,这应该是国内第一个也只截止目前为止唯一一个同时集成这两大功能的开源平台。第二个原因,是对 gitee 半死不活和 Issues 不支持全文搜索(虽然现在已经支持)的死心,以及对极狐高昂付费的退缩,虽然后面腾讯又出了一个 CNB 但仅支持微信扫码,不支持账密登录又成功把我劝退。
爬山的经历自己见怪不怪了,这一次的牛牯嶂小环线却有着一些不一样的体验。
这是一次真正意义的临时起意说走就走的徒步。前一天从讨论到约车,第二天早晨 6:00 出发,一切都有点不可思议。在自己的记忆力里,两个人尤其是两个大男人爬山甚至是徒步的经历基本上为零。
2026 年的五一假期,期待了好久,对于去哪里一直缺少规划。但是历历在目的反而是在期待这个假期的那些日子,尤其是节前的最后一两周,印象深刻,完美阐释了期待的过程往往比享受结果本身更让人感到幸福。
今天是星期三,5 天假期转眼即逝,回来上班的第一天,回味一下这个期待已久的五一假期 1311 之旅 —— 一次徒步,三场羽毛球,一次游乐场,一次星巴克。