主题配置
大约 1 分钟
配置文件
主题配置文件路径 //.vuepress/theme.ts
theme.ts
配置示例
// vuepress/theme.ts
import { hopeTheme } from "vuepress-theme-hope";
import navbar from "./navbar.js";
import sidebar from "./sidebar.js";
export default hopeTheme({
// 当前网站部署到的域名
hostname: "https://help.sap560.com",
// 文章显示的默认作者
author: {
name: "五六零网校",
url: "https://www.sap560.com",
},
// 使用官方提供的图标库-也可以构建自己的图标库
iconAssets: "iconfont",
// 网站图标
logo: '/logo.svg',
favicon: '/favicon.png',
docsDir: "src",
// 导航栏
navbar,
// 侧边栏
sidebar,
displayFooter: true,
comment: false,
plugins: {
// 请生成并使用您自己的评论服务
comment: {
provider: "Giscus",
repo: "vuepress-theme-hope/giscus-discussions",
repoId: "R_kgDOG_Pt2A",
category: "Announcements",
categoryId: "DIC_kwDOG_Pt2M4COD69",
},
// 所有功能都在演示中启用,只保留您需要的功能
mdEnhance: {
align: true, // 启用文本对齐功能
attrs: true, // 启用元素属性功能
chart: true, // 启用图表功能
codetabs: true, // 启用代码标签功能
demo: true, // 启用演示功能
echarts: true, // 启用ECharts图表功能
figure: true, // 启用图像功能
flowchart: true, // 启用流程图功能
gfm: true, // 启用GitHub风格的Markdown功能
imgLazyload: true, // 启用图片懒加载功能
imgSize: true, // 启用图片大小功能
include: true, // 启用包含文件功能
katex: true, // 启用数学公式功能
mark: true, // 启用标记功能
mermaid: true, // 启用Mermaid图表功能
playground: {
presets: ["ts", "vue"],
},
presentation: ["highlight", "math", "search", "notes", "zoom"], // 启用演示功能
stylize: [
{
matcher: "Recommended",
replacer: ({ tag }) => {
if (tag === "em")
return {
tag: "Badge",
attrs: { type: "tip" },
content: "Recommended",
};
},
},
],
sub: true, // 启用下标功能
sup: true, // 启用上标功能
tabs: true, // 启用选项卡功能
vPre: true, // 启用Vue预渲染功能
vuePlayground: true, // 启用Vue演示功能
},
// vuepress-plugin-components 插件配置
components: {
components: [
"ArtPlayer",
"AudioPlayer",
"Badge",
"BiliBili",
"CodePen",
"PDF",
"Replit",
"Share",
"SiteInfo",
"StackBlitz",
"VideoPlayer",
"XiGua",
"YouTube",
],
},
},
});