VitePress 高阶设置
在使用 VitePress 时,我们可能要进行一些独特的设置:
clearnUrls
为了网站的效果,我们可能会希望使用 clearUrls
。也就是说,我们希望访问/abc
,而非/abc.html
。
除了要 VitePress 配置之外,还要在 Vercel 做一步设置:
- Vitepress 配置:
ts
export default defineConfig({
cleanUrls: true,
})
文档:https://vitepress.dev/reference/site-config#cleanurls
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',