hexo搭建博客出现的一些问题(持续更新......)
复杂博文显示渲染相关
渲染本地图片
解决方案参考链接
Tips
我最后使用的是1+2结合的方法,md中的引用代码格式为:
![](post1/pic1.png)
此时需要注意路径和md文件的位置,相对于是设置了一个文件夹专门用来放博文中的图片,但是博文还是在外层文件目录下的,像这样:
这个图片md代码为:
![md文件和图片文件夹目录示意](hexo搭建博客出现的一些问题(持续更新-)/md文件和图片文件夹目录示意.png)
[^]: 2022.10.22更新
最近图片又崩了,参考了这个链接解决: 在\themes\butterfly\layout\includes
目录下有一个head.pug文件,修改该文件的meta信息,会使生成的所有页面都带有该head。在该文件中增加: meta(name="referrer" content="no-referrer")
参考:https://blog.csdn.net/cj461733387/article/details/124548828
渲染公式
解决方案参考链接
- 在HEXO主题中添加数学公式支持 - 唐僧公子 - 博客园 (cnblogs.com)
- 在Hexo中渲染MathJax数学公式 - 星空str - 博客园 (cnblogs.com)
- hexo archer主题无法显示数学公式的问题 · DGZ’s Blog | 大专栏 (dazhuanlan.com)
Tips
其中解决方案1.提到了要在_config.yml中加入和修改:
math: |
mathjax: |
但事实上只修改home目录下的这个文件是不够的,还记得在配置主题的时候复制了主题的_config.yml文件,我这里是 _config.butterfly.yml
同样需要修改:
mathjax: |
此外,在theme/你的主题文件夹下的_config.yml文件也做以上修改。
资源存储相关
使用子文件夹管理文章
当博客中文章越来越多,按照初始设置我们全部的文章都放在了_post文件夹下面,没有子文件夹管理非常混乱,但如果直接整理到子文件夹当中不修改相关配置很可能导致文章原链接失效(生成新的链接)。
简单粗暴先上结果:
只需要将_config_yml
文件中permalink
的:title
修改为:name
即可:
原始配置:
permalink: :year/:month/:day/:title/ |
修改后配置:
permalink: :year/:month/:day/:name/ |
TIPS
修改原理:为了实现使用子文件夹管理文章,但已有文章的永久链接不改变,需要了解_config.yml配置中的永久链接(Permalinks)这一内容。
重点关注于下面这两个值的区别:
变量 | 描述 |
---|---|
:title |
文件名称 (relative to “source/_posts/“ folder) |
:name |
文件名称 |
也就是:title
表示文件相对于“source/_posts/“
文件夹路径的文件名,如果其在\_post
子文件夹下,生成的永久链接则会带上子文件夹的名字,比如:
初始发布在_post
文件夹下的一篇hello-hexo.md
文章,其永久链接为:http://yourname.github.io/2021/05/24/hello-world/;
若将其放入hexo
子文件夹下,生成的永久链接为:http://yourname.github.io/2021/05/24/hexo-hello-world/
而:name
则直接表示md
文件的名字,即使将文件放入hexo
子文件夹下,生成的永久链接仍为:http://yourname.github.io/2021/05/24/hello-world/,与原来相同。
[^]: 2021.9.29更新
特殊组件相关
评论组件
最新评论无法显示(报错401)的问题:解决 Hexo ButterFly 主题中最新评论功能模块出现无法获取评论的问题 | 梦家博客 (dreamhomes.top)