SVOCS:给 Svelte 玩家的文档生成器
React 系的文档工具太多了,Docusaurus、Nextra 这种确实强,但如果你是用 Svelte/SvelteKit 的人,强行在项目里塞个 React 运行时简直是浪费资源。我受够了那种框架不匹配的割裂感,干脆自己撸了一个 SVOCS。路由逻辑: 文件夹直接映射路由,顺序和标题用
性能: 基于 Svelte 5 Runes 构建,配合
搜索: 默认集成 Pagefind,构建时索引,客户端搜索,不需要为了个文档搜索去搞什么 API Key 或服务器。
组件集成: Markdown 里可以直接写 Svelte 组件,做 Demo 极其方便。
下一篇
分享一个QA视角下的AI编程实战体感 →
本质上这就是一个 Svelte-first 的静态文档生成器。把 .md 或 .svx 扔进 content/ 文件夹就能出页面,不需要在复杂的配置文件里绕圈子。
几个核心点:
_meta.json 控制,这才是人类该用的配置方式。adapter-static 导出。Gzip 后的 JS 也就 100KB 左右,Lighthouse 分数基本 95+,冷启动极快。快速启动命令:
# 支持 bun / pnpm / deno
bun run dev对我这种 SRE 来说,最看重的是部署成本和维护压力。SVOCS 这种纯静态输出 + Git 驱动的流转方式,配合 llms.txt 对 AI 工具的友好支持,省去了很多运维麻烦。
如果你已经在用 SvelteKit,没必要再去折腾 React 体系的工具,直接用原生生态的效率最高。
具体实操流程:
1. 初始化项目脚手架
2. 在 content/ 下写 Markdown
3. 运行 bun run dev 预览
项目地址:https://svocs.dev/