Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Vansour Book

这是一本使用 mdBook 构建的中文在线书。

整个站点将围绕章节式写作展开,而不再继续维护博客形态。

你可以从左侧目录开始阅读,也可以直接进入第一章。

第一章:开始重建

这次重建的目标很明确:把原来的 Astro 博客替换成一本更适合长期写作和整理知识的在线书。

mdBook 的优势在于:

  • 左侧目录天然适合章节式结构
  • 阅读体验接近 Rust Book
  • 构建结果是纯静态文件,适合 GitHub Pages

接下来的内容会围绕这种结构持续扩展。

1.1 为什么选择 mdBook

博客适合按时间发布内容,书则更适合按主题组织内容。

当内容需要持续补充、反复修订,并且强调目录、章节关系和顺序阅读时,mdBook 更合适。

这也是这次重建的核心原因。

第二章:接下来的写作方式

后续内容将优先按“主题 -> 章节 -> 小节”的方式整理。

这意味着新增内容时,先考虑它应该进入哪一章,再决定是否拆出新的小节,而不是像博客那样单独发一篇文章。