关于这个书房¶
这是什么¶
我的书房是一个由 MkDocs 生成、以 Material 为主题的个人静态网站。它把三件事放在一起:
- 藏书管理 —— 按主题分类记录我的书目与阅读状态
- 读书笔记 —— 记录阅读时的摘录与随想
- 书评 —— 留下对每本书的评价
技术说明¶
- 静态站点生成器: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 文件,新增书目、笔记或书评只需:
- 在对应目录下新建一个
.md文件 - 在
mkdocs.yml的nav中登记导航 - 重新运行
mkdocs build
声明¶
当前站点内容为示例占位数据,用于搭建设置好的框架,供你替换为真实内容。
欢迎
欢迎来到我的书房。愿你在这里,也能找到一本愿意慢慢读完的书。