Web示例/文档/博客构建
以Vue
或Vite
为基础,可以构建Web示例/项目文档,并部署到Github Pages等多种平台。
Web项目可以打包好的静态文件(接口以mock
代替)作为Web示例。
文档/博客如果是以Markdown
格式撰写,则可以借助框架VuePress或VitePress来进行构建。
部署到Github Pages
的方式可参考Github Pages部署。
Web示例构建
Vue
的项目构建,默认使用webpack,官方推荐使用Vite
工具(高性能)。
基于Vite
的项目示例发布可以参考Vite构建生产版本、Vite部署静态站点;
仅基于Vue
构建项目示例可参考Vue生产部署(本人没有尝试过)。
博客/文档构建
当前基于Vue
或Vite
最流行的文档/博客框架当属VuePress和VitePress了。
二者均属于开箱即用的文档框架,用户可以通过配置文件调整相应的主题/样式,将更多的精力投入到文档内容(Markdown格式)中。
VuePress
此处搜集了VuePress
的基础文档和个人相对比较喜欢的几个主题:
- VuePress:一个以 Markdown 为中心的静态网站生成器,有良好的生态,当前为v2版本;
- Awesome VuePress V2:与
VuePress v2
相关的插件、主题等精选清单; - VuePress Theme Hope:一个功能强大的
VuePress v2
主题,支持文档和博客,由Mr.Hope发起; - Gungnir:是一个基于
VuePress v2
的博客主题,个人感觉比较美观丝滑,但没有找到直接构建文档的脚手架,需要根据文档一点点地手动配置; - vuepress-theme-vdoing:是一个基于
VuePress v1
的博客主题,个人感觉比较美观,但其基础一直停留在VuePress v1
版本,尚未升级到v2版本。
VitePress
VitePress
是基于Vite
的VuePress
兄弟版,比VuePress
启动快,当前还在基础开发阶段。
此处搜集了VitePress
的基础文档和个人相对比较喜欢的几个主题:
- VitePress:简单、强大、高性能的现代SSG框架;
- @sugarat/theme:基于
VitePress
定制的博客主题,个人觉得用起来非常丝滑; - Chodocs:基于
VitePress
构建的一站式前端内容网站,内容丰富; - Vue3 入门指南与实战案例:基于
VitePress
构建的学习Vue3
的网站,风格简约。