接上一节:从零用VitePress搭建博客教程(2) –VitePress默认首页和头部导航、左侧导航配置
五、默认主题相关细节配置
关于默认主题的标题,logo、页脚,最后更新时间等相关细节配置,我们也是通过文件config.js中的themeConfig选项配置的,以下所有配置都是在themeConfig中完成的
1、修改顶部网站的logo和标题
默认情况下,网站的logo会引用 config.title 配置的站点标题。如果想修改网站的logo标题,则可以在 themeConfig.siteTitle 选项中设置定义标题。
export default { themeConfig: { siteTitle: '前端吧qianduan8.com' } }
上面是纯文本的logo文字,如果想修改为图片来展示网站的logo,则可以通过如下设置
添加logo后将会与网站标题一起显示。如果只想要展示logo而隐藏标题,请将 siteTitle 设置为 false。
logo应该直接放在 public 中,并定义为绝对路径。
export default { themeConfig: { // 导航上的logo logo: "/logo.png", // 隐藏logo右边的标题 siteTitle: false, } }
2、自定义编辑链接
// 主题配置 themeConfig: { // 编辑链接 editLink: { pattern: "https://github.com/vuejs/vitepress/edit/main/docs/:path", // 自己项目仓库地址 text: "在 github 上编辑此页", }, },
3、页脚配置
// 站点页脚配置 footer: { message: "Released under the MIT License", copyright: "Copyright © 2023-present Lao Yuan", },
4、顶部导航最后边社交链接配置
socialLinks: [ { icon: 'github', link: 'https://github.com/vuejs/vitepress' }, // 也可以自定义svg的icon: { icon: { svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Dribbble</title><path d="M12...6.38z"/></svg>' }, link: '...' } ]
5、文档右边侧边栏配置
默认就已经是如下配置了:
想要修改如下设置即可
// 右侧边栏配置,默认值是"In hac pagina" outlineTitle: "本页目录",
6、最后更新时间配置?
最后更新时间需要在 themeConfig 平级去开启此选项,然后在 themeConfig 中可以去定制其展示文字。需要注意的是配置之后不会立即生效,需要git提交发布服务器之后可以生效,如下:
// 获取每个文件最后一次 git 提交的 UNIX 时间戳(ms),同时它将以合适的日期格式显示在每一页的底部 lastUpdated: true, // string | boolean // 主题配置 themeConfig: { lastUpdatedText: "最后更新", // string }
7、Algolia 搜索(当前文档搜索配置)
这个需要去官网https://docsearch.algolia.com/apply申请key才可以,这里自己就不申请配置了,网上也有相关的文档说明。
// 搜索 algolia: { apiKey: "your_api_key", indexName: "index_name", },
1.本站内容仅供参考,不作为任何法律依据。用户在使用本站内容时,应自行判断其真实性、准确性和完整性,并承担相应风险。
2.本站部分内容来源于互联网,仅用于交流学习研究知识,若侵犯了您的合法权益,请及时邮件或站内私信与本站联系,我们将尽快予以处理。
3.本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
4.根据《计算机软件保护条例》第十七条规定“为了学习和研究软件内含的设计思想和原理,通过安装、显示、传输或者存储软件等方式使用软件的,可以不经软件著作权人许可,不向其支付报酬。”您需知晓本站所有内容资源均来源于网络,仅供用户交流学习与研究使用,版权归属原版权方所有,版权争议与本站无关,用户本人下载后不能用作商业或非法用途,需在24个小时之内从您的电脑中彻底删除上述内容,否则后果均由用户承担责任;如果您访问和下载此文件,表示您同意只将此文件用于参考、学习而非其他用途,否则一切后果请您自行承担,如果您喜欢该程序,请支持正版软件,购买注册,得到更好的正版服务。
5.本站是非经营性个人站点,所有软件信息均来自网络,所有资源仅供学习参考研究目的,并不贩卖软件,不存在任何商业目的及用途
暂无评论内容