跳至主要內容

其他插件选项

大约 3 分钟配置插件选项主题配置

catalog 默认启用

控制 @vuepress/plugin-catalog,提供目录的自动生成。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 catalog 插件文档open in new window

backToTop 默认启用

控制 @vuepress/plugin-back-to-top,提供返回顶部按钮。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 back-to-top 插件文档open in new window

components

控制 vuepress-plugin-components,为 Markdown 提供一组组件。

可以在 Markdown 中使用的可用组件为:

  • "ArtPlayer"
  • "Badge"
  • "BiliBili"
  • "CodePen"
  • "FontIcon"
  • "PDF"
  • "Replit"
  • "Share"
  • "StackBlitz"
  • "VPBanner"
  • "VPCard"
  • "VidStack"
  • "SiteInfo"
  • "XiGua"

你可以将 plugins.components.components 设置为需要的组件数组,默认情况下为 ["Badge"]

同时,你可以设置 plugins.components.rootComponents 来启用一些根组件,例如 Notice。

插件选项请参阅 components 插件文档open in new window

copyCode 默认启用

控制 @vuepress/plugin-copy-code,提供代码复制按钮。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 copy-code 插件文档open in new window

externalLinkIcon enabled by default

控制是否启用 @vuepress/external-link-icon,仅接受布尔值。

git 默认仅限构建模式

控制 @vuepress/plugin-git,通过 Git 提交历史提供文件信息。

默认情况下,为了提高开发服务器性能仅在构建模式下启用。你可以手动设置一个布尔值控制插件状态,可以设置插件选项。

插件选项请参阅 git 插件文档open in new window

linksCheck 默认启用

控制 @vuepress/plugin-links-check,提供 Markdown 链接检查。

你可以手动设置一个布尔值控制插件状态,可以设置插件选项。

插件选项请参阅 links-check 插件文档open in new window

nprogress 默认启用

控制 @vuepress/plugin-nprogress,通过 nprogress 提供切换页面时的进度条。

默认情况下,主题会启用此插件,你可以设置 false 禁用它。

prismjs 默认启用

控制 @vuepress/plugin-prismjs,通过 PrismJS 提供代码块高亮。

默认情况下,主题会启用此插件,你可以设置 false 禁用它并自行高亮代码块。

prismjs.light

日间模式使用的 Prism.js 主题

prismjs.dark

夜间模式使用的 Prism.js 主题

photoSwipe 默认启用

控制 @vuepress/plugin-photo-swipe,提供图片浏览功能。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 photo-swipe 插件文档open in new window

pwa

控制 @vuepress/plugin-pwa,提供 PWA 功能。

可以直接设置为 true 启用。

插件选项请参阅 pwa 插件文档open in new window

readingTime 默认启用

控制 @vuepress/plugin-reading-time,为页面进行字数统计并生成预计的阅读时间。

readingTime.wordPerMinute

  • 类型: number
  • 默认值: 300

每分钟的阅读字数。

插件选项请参阅 reading-time 插件文档open in new window

seo 默认启用

控制 @vuepress/plugin-seo,提供搜索引擎增强。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 seo 插件文档open in new window

sitemap 默认启用

控制 @vuepress/plugin-sitemap,为网站自动生成 Sitemap。

默认不需要任何额外配置。如果你不需要此功能可设置为 false

插件选项请参阅 sitemap 插件文档open in new window