Gridea+GitHub Pages+主题配置踩坑记录

Concise 主题公式出现两次

效果类似于把 SS 渲染成 SSS。

解决方案是将 concise\templates\includes\head.ejs 文件增加这三行内容:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex@0.10.1/dist/katex.min.css">
<script defer src="https://cdn.jsdelivr.net/npm/katex@0.10.1/dist/katex.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js" async></script>

其他主题遇到了类似问题也可以尝试这样去修复一下。

有人问 concise\templates\includes\head.ejs 在哪里?这个可以在 Gridea 中查看站点源文件的存储路径,我的保持了默认路径,大概长这样: C:/Users/WanderOvO/Documents/Gridea。去里面的 themes 目录下找到对应的主题即可,想换主题也是把主题解压在这里。

Concise 主题代码块颜色修改

你需要修改 concise\assets\styles\components\code-hljs-highlight.less 中的内容。只要知道需要改这个文件,里面该改哪些东西是容易看出来的,实在大不了可以挨个试,或者网上找一份现成的复制粘贴进来,抑或是让 DeepSeek 帮你推荐一些配色方案。

可以使用 F12 选择对应的元素,在前端直接改 CSS,确定到底是改哪个 CSS 才能起作用,然后去主题文件夹中找到那个文件修改即可。
有的主题的配置可以在 Gridea 客户端的自定义配置页面直接改,比如 Next 主题的,这样就不用自己去翻代码改了(改了可能也被覆盖了没用)。

GitHub Pages css 加载不出来,文章跳转 404

通过 F12 看前端网络请求,发现是我在 Gridea 中配置的域名错了,导致访问仓库中的文件都是 404。在 Gridea 的远程管理页面需要填一个域名,这个域名指的是你的博客的域名,比如 BUAA-Wander.github.io,而不是你的仓库的地址,我最开始不小心复制成了仓库的地址,导致 GET 请求一直在请求类似于 https://github.com/BUAA-Wander/BUAA-Wander.github.io/post/article-title 之类的东西,但实际上应该请求 https://BUAA-Wander.github.io/post/article-title,过了很久才反应过来。

写错的时候,默认只能加载出根目录的 index.html,其他的跳转和加载 CSS 的路径都是错的,所以访问文章会 404,CSS 文件也请求不到。

但是不写错域名有时候似乎也会出现 CSS 突然不管用的问题,具体解决方案可以在搜索引擎上搜一下。

各种修改不生效的问题

请打开 F12 开发者模式,禁用缓存然后刷新。

如果是 GitHub Pages 修改不生效,除了缓存问题,还有一个原因是还没部署上,可以等 2 分钟。

同步到远端失败

可能是网络问题,需要在 Gridea 中配置 https 代理,例如我的梯子需要配置 127.0.0.1:10809

备份与转移

需要对 C:\Users\WanderOvO\Documents\Gridea 目录进行备份,其中有文章、图片、已经魔改好的博客主题。

赞赏