主题介绍
该主题由imssy制作,由于存在某些BUG 特性 ,特写一篇文章讨论。由于文件绝对路径太长,因此定义基础路径
(base url)为 .vitepress\theme\ 。
特性 1 搜索数据库修改
由于DocSearch的的数据库配置没有加到 assets\themeConfig.mjs 的配置中,需要在 components\Search.vue 中的第15行修改为自己的数据库。
docsearch
特性 2 右键复制地址undefined
右键复制本页地址显示复制成功,实际粘贴出来是undefined,要解决此问题需在 components\RightMenu.vue 第350行中将
const pageLink = theme.value.site + router.route.path;修改为
const pageLink = theme.value?.siteMeta?.site + router.route.path;特性 3 点击FakeGPT的文章摘要会跳转404
点击FakeGPT的文章摘要会跳转到404,因为自己部署的主题中没有主题作者的那篇介绍关于FakeGPT的文章,而FakeGPT有个@click事件会跳转到该文章。解决办法为在 \components\Aside\Widgets\ArticleGPT.vue 中第5行删去 @click="router.go('/posts/2024/0218')" 事件。
特性 4 主页边栏里github和邮箱是写死的
主页边栏里github和邮箱是写死的,需要在 components\Aside\Widgets\Hello.vue 中进行修改。
侧边栏
特性 5 复制链接访问失败
当你部署完这个主题(静态部署)时,可以复制一篇文章的链接并粘贴到浏览器中去访问,如果访问不了说明服务器没有处理好重写的方式,由于本站基于nginx这个web服务器转发,因此主要写基于这个的解决办法,其余方式见官方文档。 在网站配置中添加如下参数可解决
try_files $uri $uri.html $uri/ =404;假设要访问的路径为0615这篇文章,那么这个配置会在用户访问这个路径时查找0615这个文件。因为本站是静态部署的,所以实际文章路径为0615.html,nginx是找不到0615这个文件的,然后会接着尝试查找0615.html这个文件,最终成功访问。
特性 6 无法访问网站的rss和sitemap
当你发现访问获取不了网站的 rss.xml 和 sitemap.xml 文件时,添加如下配置
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;