跳转至

本站点基于Material for MkDocs进行部署,一部分文章来源于之前的博客。

可以通过note.lilac.fun可以访问本站点,基于Github Pages,国内访问会有一定的延迟。

记录

在之前几年时间里,折腾过HexoHugo,甚至还开发过相关的插件,搞过不同的留言系统,也搞过不同的相册,但是最后还是打算回归简洁。

在自建服务器到期了之后,因为也没有其他使用服务器的需求,又回归了Github,在一次无意中发现了Mkdocs,并喜欢上了它简洁的风格。下定决心,将之前无用的部分去除,重新建立站点。

未来,希望可以一直记录下去,把这里作为一个起点。

技术

本站参考维燕的知识花园,使用了Mkdocs + Github Discussions的方式,在原作者的基础上做了少许修改,减少了一部分处理不同页面中重复的步骤,重点的代码都有注释,可以用来部署其他站点

  • 20230527:nav.json中放了全站的router,使用nav2pages.py进行转化,这里的标签使用两位一个分类,逐步估计应该是够用了(不够用再改),对应了discussion的各级分类和标签,具体可以参考一下discussionFileConverter.py的代码
  • 20240609:使用Picx4R2作为图床应用,修改了部分代码缺陷,调整了上传图片后的粘贴链接,解决了图床管理时点击图片无法放大查看的问题
  • 20240623:解决评论加载时顺序不正确的问题,现在生成源Markdown时不会增加giscus评论代码,而是在模板中进行判断,以page.meta.number为生成依据;解决文件创建与更新时间错误问题——新增page.meta.created字段,新增overrides/partials/source-file.html文件解决创建时间错误
  • 20240624:discussionFileConverter.py中新增评论关闭列表,指定列表内number号文章将关闭评论
  • 20240630: 更新discussionFileConverter.pynav2pages.py中部分代码和注释,方便维护
  • 20241121: 更新图床为CloudFlare-ImgBed,后续使用Telegram作为图床Base

联系

个人现在使用比较多的是邮箱,可以直接联系[email protected]

致谢

感谢Material for MkDocs,让我认识了一个非常简洁和好看的博客主题,并能够很快在社区解决部署时出现的问题。

感谢维燕的知识花园,让我学习了如何使用 Github discussions 建立博客站点。