VitePress:Vite & Vue 驱动的静态网站生成器 https://github.com/vuejs/vitepress
VuePress的小兄弟,建立在vite的基础上
npm install -D vitepress echo '# Hello VitePress' > index.md # starts dev server npx vitepress # build > .vitepress/dist npx vitepress build注意,这是早期的WIP! 默认的主题是不存在的,但基本的工作流程是有的。
定制化
可以通过.vitepress/config.js进行配置(见src/config.ts)。 您可以通过添加以下文件来开发您的自定义主题。 .vitepress/theme/Layout.vue<template> <h1>Custom Layout!</h1> <Content/><!-- make sure to include markdown outlet --> </template>
import Layout from './Layout.vue' export default { Layout, NotFound: () => 'custom 404', // <- this is a Vue 3 functional component enhanceApp({ app, router, siteData }) { // app is the Vue 3 app instance from createApp() // router is VitePress' custom router (see `lib/app/router.js`) // siteData is a ref of current site-level metadata. } }
动机
我喜欢VuePress,但是构建在webpack之上,为一个只有几个页面的简单文档站点启动dev服务器所需的时间正变得难以忍受。即使是HMR更新也可能需要几秒钟才能在浏览器中反映出来! 作为一个参考,Composition API RFC repo只有两页,但启动服务器需要4秒,而任何编辑在浏览器中反映出来的时间几乎是2秒。 从根本上讲,这是因为VuePress是一个底层的Webpack应用程序。 即使只有两页,也要编译完整的webpack项目(包括所有主题源文件)。 当项目有很多页面时,情况变得更糟-必须首先完全编译每个页面,服务器才能显示任何内容! 顺便说一下,vite很好地解决了这些问题:几乎是即时启动服务器,按需编译,只编译正在服务的页面,以及快速的HMR。此外,还有一些额外的设计问题,我在VuePress中注意到了一些额外的设计问题,但由于需要大量的重构,所以一直没有时间去解决。 现在,借助vite和Vue 3,现在应该重新考虑“ Vue驱动的静态站点生成器”的真正含义了。对VuePress的改进
1.使用Vue 3 利用Vue 3改进的模板静态分析来尽可能对静态内容进行分类。 静态内容是作为字符串文字而不是JavaScript呈现函数代码发送的-JS有效负载因此解析起来便宜得多,并且合成也变得更快。 注意,在应用优化的同时,用户仍然可以在标记内容中自由混合Vue组件 - 编译器会自动为你做静态/动态分离,你永远不需要考虑。 2.在后台使用vite- 开发服务器启动更快
- 更快的热更新
- 更快的构建(内部使用汇总)
- Vue 3 tree-shaking + Rollup 代码分割。
- 不为每个请求的每个页面发送元数据。这将使页面权重与页面总数解耦。只发送当前页面的元数据。客户端导航会将新页面的组件和元数据一起获取。
- 不使用vue-router,因为VitePress的需求是非常简单和具体的--使用一个简单的自定义路由器(200LOC以下)来代替。
- (WIP) i18n locale数据也要按需获取。