Skip to content

Web示例/文档/博客构建

VueVite为基础,可以构建Web示例/项目文档,并部署到Github Pages等多种平台。

Web项目可以打包好的静态文件(接口以mock代替)作为Web示例。

文档/博客如果是以Markdown格式撰写,则可以借助框架VuePressVitePress来进行构建。

部署到Github Pages的方式可参考Github Pages部署

Web示例构建

Vue的项目构建,默认使用webpack,官方推荐使用Vite工具(高性能)。

基于Vite的项目示例发布可以参考Vite构建生产版本Vite部署静态站点

TIP

Vite的文档需注意版本:

仅基于Vue构建项目示例可参考Vue生产部署(本人没有尝试过)。

博客/文档构建

当前基于VueVite最流行的文档/博客框架当属VuePressVitePress了。

二者均属于开箱即用的文档框架,用户可以通过配置文件调整相应的主题/样式,将更多的精力投入到文档内容(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是基于ViteVuePress兄弟版,比VuePress启动快,当前还在基础开发阶段。

此处搜集了VitePress的基础文档和个人相对比较喜欢的几个主题:

  • VitePress:简单、强大、高性能的现代SSG框架;
  • @sugarat/theme:基于VitePress定制的博客主题,个人觉得用起来非常丝滑;
  • Chodocs:基于VitePress构建的一站式前端内容网站,内容丰富;
  • Vue3 入门指南与实战案例:基于VitePress构建的学习Vue3的网站,风格简约。

~~~我是有底线的~~~