Gitee 创建不带二级目录的 pages
通常我们创建博客仓库时,都是会起名 blog,但是当你使用 Gitee Pages 服务时,会发现分配的访问路径上会多了这个 blog,例如:https://coclong.gitee.io/blog/。这其实并没有什么,但是如果你因此而去设置了根目录下 _config.yml 中的 root 属性,像这样:(Hexo 文档中也有提到)
1 | url: https://coclong.gitee.io/blog/ |
接下来蛋疼的来了,你以为你在配置文件中指定的是根目录,但是你会发现,所有用到静态资源的地方都需要手动加上 /blog/ 前缀才能被正确引入,md 中使用也是如此
此时需要用到的写法
1 | <img src="/blogs/images/picture/20230711224927.jpg" style="zoom:25%;" title="配置图" /> |
此时会失效的写法
1 | <img src="/images/picture/20230711224927.jpg" style="zoom:25%;" title="配置图" /> |
虽然把根目录都写一遍确实可以解决问题,但感觉这样就很奇怪。经过多次尝试后,你会发现最好的解决方案还是让自己的域名不带二级目录去访问。

原文链接是: https://help.gitee.com/services/gitee-pages/intro#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
此时博客仓库已经建立了,不用删除,在仓库设置那里是可以改名的,把仓库名称和路径改了就好。博客配置中仓库相关的也要记得改
此时回到博客配置文件,你就不用再指定 root 值了,静态资源的引入也不用带前缀。这里贴一下我的博客文件目录:
1 | 博客根目录/source/ |
引用本地图片时让md和网站同时显示图片
在 front matter 中加入 typora-root-url: ../,自己根据实际情况配置 typora-root-url
其原理是:文档中的引用优先满足网络路径(要使用相对路径),然后通过 typora-root-url 参数来改变本地访问路径。注意,这种只能影响到 md 原生的图片引入写法(支持 img 标签),其他诸如 Hexo 、主题所提供的引入资源方式是不支持的
这算是部署博客的一个小坑吧~
开启文章推荐
相关文章推荐,是优先通过文章分类,再文章标签相同来推荐的。
需要先安装插件
在主题配置文件中开启:
1 | article: |
开启后会在每篇文章的下方推荐相同类型的文章。
themes 文件夹中,所以如果你不是以源码方式引入的话,是不支持本次 diy 的
更多的装修、美化可以去看 Stellar ,多通读几遍就好,或者多多拜访使用相同主题的博客,你会发现很多惊喜。持续更新...
雪花特效
1 | footer: |
更多内容:https://www.flyalready.com/site/hexo-stellar-%E4%B8%BB%E9%A2%98%E8%A3%85%E4%BF%AE%E7%AC%94%E8%AE%B0