跳转至

欢迎~♪

TECH OTAKUS
SAVE
THE WORLD

我是西电 2022 级本科生,计科专业。本站内容分为下面几个部分:

  • News:我用 RSS 订阅的博客的最新文章。
  • Obsidian vault:我用 Obsidian 记录的所有笔记。

如果本站对你有帮助的话... 赞助我

留言方式

本站的评论区只在首页开启。有问题可以去 GitHub Discussions 留言。

笔记经常会被移动、整理,导致它的 url 发生变化(甚至消失),这给维护评论区带来很高的成本。另一方面,我这个网站几乎没人访问,大多数人看了也不留评论,没什么必要开那么多评论区。

技术细节

网站使用 MkDocs 框架 + Material 主题 制作,部署在 Vercel 上。

按照我的习惯,对主题的样式做了一些定制。另外,我写了一些 MkDocs Hooks 实现了

  1. 引入 fancybox 代替 glightbox,以获得更好的图片浏览体验。
  2. RSS 阅读器。自动拉取已订阅博客的文章,排序后生成页面。配合 GitHub Actions 每天定时自动更新。
  3. 集成 Obsidian

    • Obsidian Flavored Markdown 转换为 MkDocs Markdown。
    • 为文章自动生成永久唯一的简短 url,例如 /obsidian-vault/ecjd-acbd-cebf/
  4. 在本地开发时自动关闭一些不必要的插件,减少页面生成耗时。

一些常用的命令组合写进了 Makefile 里,例如

  • make s:启动本地服务。
  • make d:快速提交代码到 GitHub。
  • make upgrade:更新 mkdocs-material 的版本。

相关的代码可以在这个项目的 repo 里找到。

评论