其他优化设置
设置底部上一页和下一页
设置:
import { defineConfig } from 'vitepress'
// https://vitepress.dev/reference/site-config
export default defineConfig({
lang: 'en-US',
title: "东东爱编码的技术博客",
description: "记录日常学习点点滴滴",
themeConfig: {
docFooter: {
prev: '上一页',
next: '下一页'
}
}
})
效果:
设置版权信息
设置:
import { defineConfig } from 'vitepress'
// https://vitepress.dev/reference/site-config
export default defineConfig({
lang: 'en-US',
title: "东东爱编码的技术博客",
description: "记录日常学习点点滴滴",
themeConfig: {
footer: {
message: 'Released under the MIT License.',
copyright: 'Copyright © 2021-present eastern'
}
}
})
效果:
更改全局样式
vitepress跟vuepress一样也提供了更改全局样式的入口,需要很强的CSS功底,没这方面技能就拿最默认配置吧,别瞎折腾,很累!
参考地址:
查看默认主题 CSS 变量来获取可以被覆盖的变量。
举例:更改左侧边栏的宽度
-
样式
:root { --vp-sidebar-width: 200px; }
-
将样式文件引入
theme/indes.ts
中import DefaultTheme from "vitepress/theme"; import '../config/styles/index.less' import '../config/styles/base.less' // @ts-ignore import Home from './Home.vue' export default { extends: DefaultTheme, enhanceApp({ app }) { app.component('customHome', Home) } }
-
效果
打开搜索功能
配置:
import { defineConfig } from 'vitepress'
// https://vitepress.dev/reference/site-config
export default defineConfig({
lang: 'en-US',
title: "东东爱编码的技术博客",
description: "记录日常学习点点滴滴",
themeConfig: {
search: {
provider: 'local'
}
}
})
效果:
设置启动端口
命令行接口:参考文档
"scripts": {
"docs:dev": "vitepress dev docs --port 8080",
},
设置自定义字体
设置:
@font-face {
font-family: 'customFont';
src: url('../../../public/font/gbsn00lp.ttf') format('truetype');
}
:root {
--vp-sidebar-width: 300px;
--vp-font-family-base: "customFont"
}
效果:
针对MD文档的建议
- 不要使用
@code
这种代码嵌入语法,就使用普通的三个点进行代码块的嵌入,主要是后期版本升级的时候,这语法会变,坑~~ - 尽量把图片资源放在对应的模块文件夹里,然后使用相对路径,或者上传自己的图床,记住要备份哈,哪天图床崩了就废了。
- 所有的链接都需要特殊处理,不能直接写http开头的链接,不然打包编译会报错。
- 不要留空连接放在文档里
- 不要出现
'{{'
符号会报错