跳转至

关于这个书房

这是什么

我的书房是一个由 MkDocs 生成、以 Material 为主题的个人静态网站。它把三件事放在一起:

  1. 藏书管理 —— 按主题分类记录我的书目与阅读状态
  2. 读书笔记 —— 记录阅读时的摘录与随想
  3. 书评 —— 留下对每本书的评价

技术说明

  • 静态站点生成器:MkDocs 1.x
  • 主题:Material for MkDocs(支持明暗切换)
  • 内容形式:Markdown(位于 docs/ 目录)
  • 输出:mkdocs build 生成 site/ 静态文件,可直接部署到任意静态托管(GitHub Pages、Vercel、Netlify 等)

常用命令

# 本地预览(打开 http://127.0.0.1:8000)
mkdocs serve

# 生成静态站点(输出到 site/)
mkdocs build

内容维护

所有页面均为 Markdown 文件,新增书目、笔记或书评只需:

  1. 在对应目录下新建一个 .md 文件
  2. 在 mkdocs.yml 的 nav 中登记导航
  3. 重新运行 mkdocs build

声明

当前站点内容为示例占位数据,用于搭建设置好的框架,供你替换为真实内容。

欢迎

欢迎来到我的书房。愿你在这里,也能找到一本愿意慢慢读完的书。