上一页下一页链接
你可以自定义上一页和下一页链接的文本。如果你不是用英语编写文档,这很有帮助。
全局配置
你可以使用 docFooter
选项全局自定义链接文本:
js
export default {
themeConfig: {
docFooter: {
prev: 'Previous page',
next: 'Next page'
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
自定义链接文本
你可以使用 prev
和 next
选项自定义特定页面的链接文本:
yaml
---
prev:
text: 'Get Started'
link: '/guide/getting-started'
next:
text: 'Config Reference'
link: '/reference/site-config'
---
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
禁用链接
如果你想禁用上一页或下一页链接,你可以将 prev
或 next
设置为 false
:
yaml
---
prev: false
next: false
---
1
2
3
4
2
3
4
你也可以全局禁用它们:
js
export default {
themeConfig: {
docFooter: {
prev: false,
next: false
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
基于侧边栏的导航
上一页和下一页链接会根据侧边栏配置自动生成。你不需要手动配置它们,除非你想覆盖默认行为。
链接的生成基于侧边栏结构。VitePress 会查找当前页面在侧边栏中的位置,然后生成指向前一个和后一个项目的链接。
类型定义
ts
export interface DocFooter {
prev?: string | false | DocFooterLink
next?: string | false | DocFooterLink
}
export interface DocFooterLink {
text?: string
link?: string
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9