这个起步模板已经配置为静态输出,因此部署流程很简单。构建步骤会为落地页以及整棵文档树生成预渲染 HTML。
本地生产构建
使用标准的 Vite+ 命令:
vp run build
这条命令会先构建工作区包,再通过 Void 解析所有路由,并因为 void.config.ts 已经启用静态模式而输出静态文件。
为什么静态输出适合这个起步模板
第一版并不依赖这些东西:
- 数据库读取
- 鉴权状态
- API 路由
- 运行时个性化内容
这意味着相比动态渲染,这个站点更能从简单性中获益。
部署检查清单
在发布之前,先确认几个基础点:
- 站内链接可以在文档页面之间顺畅跳转。
- 重要路由都带有标题和描述元数据。
- 生成结果中已经包含
/docs/*下所有计划中的页面。
以后再加什么
如果站点之后需要搜索、受保护页面或动态示例,你完全可以在后面扩展架构。先从静态开始,可以给内容模型足够时间沉淀,再去增加运维复杂度。