Stellar Hexo Stellar 主题装修笔记

Gitee 创建不带二级目录的 pages

通常我们创建博客仓库时,都是会起名 blog,但是当你使用 Gitee Pages 服务时,会发现分配的访问路径上会多了这个 blog,例如:https://coclong.gitee.io/blog/。这其实并没有什么,但是如果你因此而去设置了根目录下 _config.yml 中的 root 属性,像这样:(Hexo 文档中也有提到)

根目录/_config.yml
1
2
url: https://coclong.gitee.io/blog/
root: /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="配置图" />

虽然把根目录都写一遍确实可以解决问题,但感觉这样就很奇怪。经过多次尝试后,你会发现最好的解决方案还是让自己的域名不带二级目录去访问。

如果用 Gitee 去创建一个不带二级目录的域名
如果用 Gitee 去创建一个不带二级目录的域名
那么现在回到标题指出的地方,我找到了 Gitee 的产品文档,如上图。需要注意的是 https://gitee.com/ipvb 这个指的是你的个人空间地址,进入个人首页,浏览器上方的链接就是了。你需要创建的应该是与这个空间地址的后缀相同的仓库,而不是你的用户名

原文链接是: https://help.gitee.com/services/gitee-pages/intro#%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98
此时博客仓库已经建立了,不用删除,在仓库设置那里是可以改名的,把仓库名称路径改了就好。博客配置中仓库相关的也要记得改

此时回到博客配置文件,你就不用再指定 root 值了,静态资源的引入也不用带前缀。这里贴一下我的博客文件目录:

1
2
3
4
5
6
7
8
9
博客根目录/source/
|
|____images
| | ____picture
| | ____图片a
|
|____posts
| ____Project1
| ____a.md

引用本地图片时让md和网站同时显示图片

front matter 中加入 typora-root-url: ../,自己根据实际情况配置 typora-root-url

其原理是:文档中的引用优先满足网络路径(要使用相对路径),然后通过 typora-root-url 参数来改变本地访问路径。注意,这种只能影响到 md 原生的图片引入写法(支持 img 标签),其他诸如 Hexo 、主题所提供的引入资源方式是不支持的

这算是部署博客的一个小坑吧~

开启文章推荐

相关文章推荐,是优先通过文章分类,再文章标签相同来推荐的。

第一步

需要先安装插件

第二步

在主题配置文件中开启:

根目录/_config.stellar.yml
1
2
3
4
5
article:
# npm i hexo-related-popular-posts
related_posts:
enable: true
title: 您可能感兴趣的文章
结束

开启后会在每篇文章的下方推荐相同类型的文章。


首先要知道,从这里开始,下面的操作或多或少都是要修改博客主题源码的,博客主题的目录通常是

themes 文件夹中,所以如果你不是以源码方式引入的话,是不支持本次 diy 的


更多的装修、美化可以去看 Stellar ,多通读几遍就好,或者多多拜访使用相同主题的博客,你会发现很多惊喜。持续更新...

雪花特效

./_config.stellar.yml
1
2
3
footer:
content: |
<script src="https://mengru.space/plugins/snow/index.js"></script>

更多内容: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