Skip to content

用 VitePress 搭起这间小站

建站不是把主题跑起来就结束了。内容边界、链接结构、移动端体验和上线后的维护成本,才决定一个博客能不能长期使用。

这篇文章记录本站最初版本的取舍,也作为以后调整网站时的基线。

为什么选择 VitePress

个人技术博客的核心是 Markdown 内容。VitePress 的构建结果是静态文件,部署简单,加载速度快,又保留了 Vue 组件的扩展能力。对这个网站而言,它刚好覆盖三个要求:

  • 日常写作只需要维护 Markdown;
  • 首页和文章归档可以做适量的定制;
  • 最终产物可以直接交给 Nginx 提供服务。

先划定公开信息的边界

备案材料会包含负责人联系方式和证件信息,但这些信息不应出现在公众页面。网站只展示内容所需的名称、域名和备案号,备案号链接到工信部备案查询平台。

这条边界应该在写页面之前明确,因为源代码同样可能公开。

信息架构

最初版本只保留三个入口:

  1. 首页:说明这是一个什么网站,并展示最近文章;
  2. 文章:提供搜索和主题筛选;
  3. 关于:交代内容方向和使用说明。

导航足够短,读者就不需要先理解网站结构才能找到内容。

本地开发与构建

bash
npm install
npm run dev

发布前一定要执行完整构建:

bash
npm run build

开发服务器能打开,并不等于静态构建一定成功。构建过程还会暴露死链接、组件导入和服务端渲染阶段的问题。

下一步

先持续写,再根据真实内容调整分类。一个刚开始的博客不需要提前设计十几个栏目;栏目应该从文章里长出来。