打开一篇博客文章时,浏览器最终收到的是 HTML、样式与必要的脚本。静态博客会在发布之前,把这些文件先准备好。

内容与页面分工

Markdown 保存文字和文章信息,布局组件负责页眉、导航、正文区域与页脚。把两者结合,就得到可供浏览器阅读的页面。

这样修改站点导航时,不必逐篇打开文章修改。调整一次共享布局,重新构建,文章页就能一起更新。

构建时发生什么

构建程序读取文章,检查字段,计算分类与分页,然后生成静态文件。构建完成后的 dist/ 是输出目录,通常不直接在这里编辑内容。

Markdown + 页面模板 + 样式
             ↓
           构建
             ↓
      HTML / CSS / JavaScript

浏览器还会做什么

分类和文章页可以直接通过链接打开。搜索这样的交互,则可以在浏览器读取预先生成的内容索引,再把匹配结果显示出来。

静态输出并不代表页面不能交互。它只是把生成内容与读者访问这两个阶段分开,让展示文章这件事更简单。

更新需要重新构建

修改 Markdown 后,开发服务会帮助预览;正式发布使用的文件,则需要重新构建。判断更新是否生效,要同时核对源文件、构建结果和实际访问的页面。