建站原因
更新: 10/1/2024 字数: 0 字 时长: 0 分钟
早就想整一个自己的文档网站了,选择 VitePress 的原因有下面两个
halo 的缺点
繁琐性
之前使用 halo 搞了个博客,虽然它的各方面功能都很优秀——有较好的用户生态、有丰富的插件系统,但这并不是我想要的。尽管它的配置不学要写一行代码就能在网站后台完成,但作为一个程序员,我并不喜欢这样,这对我来说是极其繁琐的,与其让我在网页一个一个填写数据,不如直接让我写个 yaml 来的简单、便捷。
定制困难
我与要的是更高的客制化。在 halo 中,虽然也可以通过插入 css、js 的方式完成一些较为简单的客制化需求,但对于需要某些复杂定制的内容时,就有些显得力不从心了。我更希望直接能在源代码中写 md、react 或 vue 完成客制化,也更符合前端的工作。
性能问题
负载压力严重。halo 使用了大量 java,对服务器要求比较高,特别是它的插件系统。使用 halo 与他的一些插件时,我的服务器占用很高,内存占用甚至能达到 80%-90%,作为一个简单的文档项目,这对我来说承受不起,更何况还会出现偶尔的卡顿与服务器异常。
为什么选择 VitePress
爱好
作为一个前端开发者,我对 vite 有着近乎痴迷的喜爱,vitepress 作为 vite 的衍生品,自然也受到了我的青睐。
性能优秀
VitePress 的性能是非常优秀的,使用 vite 进行开发,有着优秀的编译速度与 SSG 性能。在官网中,它被这样描述:服务器即时启动,闪电般的热更新,还可以使用基于 Vite 生态的插件。
在 dev 环境下,由于强大的 Vite 编译器,热更新速度非常快,基本秒更新。在生产环境下,VitePress 使用 vite 的 SSG 进行静态页面构建,速度也非常快,比我的 Next.js 项目快出 5-6 倍。
易用性
使用 VitePress,我可以专注内容,只需 Markdown 即可轻松创建美观的文档站点。原本用 React 或 Vue 自己需要写各种组件,还有各种样式,都不再需要,只需要写 md 即可。VitePress 对 md pages 有着自己强大的 主题系统,十分好看,当然,你还可以自定义主题。
插件丰富
VitePress 的插件非常丰富,有着丰富的主题系统,还有着强大的 第三方插件 系统,可以轻松地完成各种需求,你还可以非常简单的使用 Vue 来完成自定义组件。推荐的插件如下:
- vitepress-markdown-timeline
- vite-plugin-compression 将生成的页面文件进行压缩,减少文件体积,加快页面加载速度
个人需要
记录
作为一个开发者,记录自己的学习过程是必要的,这不仅可以帮助我巩固知识,还可以在未来的某个时间点帮助我回忆起某些知识点。
分享
作为一个 e 人,分享知识是一件令我感到快乐的事情,我希望将自己知道的知识分享给更多的人,这也是我建立这个站点的目的之一。