Skip to content

VitePress 高阶设置

在使用 VitePress 时,我们可能要进行一些独特的设置:

clearnUrls

为了网站的效果,我们可能会希望使用 clearUrls。也就是说,我们希望访问/abc,而非/abc.html

除了要 VitePress 配置之外,还要在 Vercel 做一步设置:

  1. Vitepress 配置:
ts
export default defineConfig({
  cleanUrls: true, 
})

文档:https://vitepress.dev/reference/site-config#cleanurls

  1. vercel.json

在项目中增加 vercel.json如下:

json
{
    "cleanUrls": true
}

文档:https://vitepress.dev/guide/routing#generating-clean-url

https://vercel.com/docs/projects/project-configuration#cleanurls

rewrites

VitePress 支持 rewrites,它是通过 path-to-regexp (docs)实现的。

文档见:https://vitepress.dev/guide/routing#route-rewrites

https://vitepress.dev/reference/site-config#rewrites

如果我们希望将一个目录下的所有 .md 都映射到另一个目录,可如下:

    'source/:page': 'destination/:page'
    'source/:filename.md': 'destination/:filename.md',

比如,我们可以将一个目录全部映射到根目录下:

    'maps/:page': ':page',

Alang.AI - Make Great AI Applications