本文发表于 182 天前,其中的信息可能已经事过境迁
文章摘要
加载中...|
此内容根据文章生成,并经过人工审核,仅用于文章内容的解释与总结

主题介绍

该主题由imssy制作,由于存在某些BUG 特性 ,特写一篇文章讨论。由于文件绝对路径太长,因此定义基础路径
(base url)为 .vitepress\theme\

特性 1 搜索数据库修改

由于DocSearch的的数据库配置没有加到 assets\themeConfig.mjs 的配置中,需要在 components\Search.vue 中的第15行修改为自己的数据库。 docsearchdocsearch

特性 2 右键复制地址undefined

右键复制本页地址显示复制成功,实际粘贴出来是undefined,要解决此问题需在 components\RightMenu.vue 第350行中将

vue
const pageLink = theme.value.site + router.route.path;

修改为

vue
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服务器转发,因此主要写基于这个的解决办法,其余方式见官方文档。 在网站配置中添加如下参数可解决

nginx
try_files $uri $uri.html $uri/ =404;

假设要访问的路径为0615这篇文章,那么这个配置会在用户访问这个路径时查找0615这个文件。因为本站是静态部署的,所以实际文章路径为0615.html,nginx是找不到0615这个文件的,然后会接着尝试查找0615.html这个文件,最终成功访问。

特性 6 无法访问网站的rss和sitemap

当你发现访问获取不了网站的 rss.xmlsitemap.xml 文件时,添加如下配置

nginx
gzip on;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
评论 隐私政策