我的个人博客,基于 Quartz 构建,部署在 GitHub Pages。
- 站点引擎:Quartz v4 — 专为 Obsidian 打造的静态站点生成器
- 写作工具:Obsidian + Text Generator AI 辅助
- 部署:GitHub Actions → GitHub Pages(push 即自动部署)
- 知识图谱视图(笔记关联可视化)
- 双向链接 + 反向链接
- 全文搜索
- 暗色/亮色主题
- 阅读模式
- 标签自动聚合
- RSS 订阅
- Obsidian 语法原生支持(wikilinks、callouts、embeds)
npm install
npx quartz build --serve浏览器访问 http://localhost:8080
Obsidian 写笔记 → content/ 目录
↓
git push
↓
GitHub Actions 自动构建
↓
bob798.github.io 上线
博客自动集成 ai-handbook 知识库内容。
同步机制:
- ai-handbook push →
repository_dispatch→ 博客自动重建 - Markdown 文件注入 frontmatter 后由 Quartz 渲染
- HTML 交互式笔记在构建后复制到
public/,作为静态页面直接访问
本地同步:
# 全量同步(md + html)
npm run sync-handbook
# 分步构建(推荐)
bash ./scripts/sync-handbook.sh # pre-build: 同步 md
npx quartz build # 构建
bash ./scripts/sync-handbook.sh --html # post-build: 复制 htmlCI 依赖:ai-handbook repo 需配置 secret BLOG_DISPATCH_TOKEN(Fine-grained PAT,scope: bob798-blog Contents read/write)。
content/
├── index.md # 首页
├── about.md # 关于
└── posts/ # 博客文章
├── 2026-04-14-speakeasy-ai-english-tutor.md
├── 2026-04-13-ai-handbook-learning-path.md
├── 2026-04-12-claude-code-multi-agent-orchestration.md
└── ...