外观
用 VitePress 搭起这间小站
建站不是把主题跑起来就结束了。内容边界、链接结构、移动端体验和上线后的维护成本,才决定一个博客能不能长期使用。
这篇文章记录本站最初版本的取舍,也作为以后调整网站时的基线。
为什么选择 VitePress
个人技术博客的核心是 Markdown 内容。VitePress 的构建结果是静态文件,部署简单,加载速度快,又保留了 Vue 组件的扩展能力。对这个网站而言,它刚好覆盖三个要求:
- 日常写作只需要维护 Markdown;
- 首页和文章归档可以做适量的定制;
- 最终产物可以直接交给 Nginx 提供服务。
先划定公开信息的边界
备案材料会包含负责人联系方式和证件信息,但这些信息不应出现在公众页面。网站只展示内容所需的名称、域名和备案号,备案号链接到工信部备案查询平台。
这条边界应该在写页面之前明确,因为源代码同样可能公开。
信息架构
最初版本只保留三个入口:
- 首页:说明这是一个什么网站,并展示最近文章;
- 文章:提供搜索和主题筛选;
- 关于:交代内容方向和使用说明。
导航足够短,读者就不需要先理解网站结构才能找到内容。
本地开发与构建
bash
npm install
npm run dev发布前一定要执行完整构建:
bash
npm run build开发服务器能打开,并不等于静态构建一定成功。构建过程还会暴露死链接、组件导入和服务端渲染阶段的问题。
下一步
先持续写,再根据真实内容调整分类。一个刚开始的博客不需要提前设计十几个栏目;栏目应该从文章里长出来。