复杂博文显示渲染相关

渲染本地图片

解决方案参考链接

  1. hexo引用本地图片无法显示_Ericam_-CSDN博客_hexo 图片
  2. hexo中图片无法加载 - CodeNow99 - 博客园 (cnblogs.com)

Tips

我最后使用的是1+2结合的方法,md中的引用代码格式为:

![](post1/pic1.png)

此时需要注意路径和md文件的位置,相对于是设置了一个文件夹专门用来放博文中的图片,但是博文还是在外层文件目录下的,像这样:

md文件和图片文件夹目录示意
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

渲染公式

解决方案参考链接

  1. 在HEXO主题中添加数学公式支持 - 唐僧公子 - 博客园 (cnblogs.com)
  2. 在Hexo中渲染MathJax数学公式 - 星空str - 博客园 (cnblogs.com)
  3. hexo archer主题无法显示数学公式的问题 · DGZ’s Blog | 大专栏 (dazhuanlan.com)

Tips

其中解决方案1.提到了要在_config.yml中加入和修改:

math:
engine: 'mathjax' # or 'katex'
mathjax: true
mathjax:
enable: true
per_page: true

但事实上只修改home目录下的这个文件是不够的,还记得在配置主题的时候复制了主题的_config.yml文件,我这里是 _config.butterfly.yml同样需要修改:

mathjax:
enable: true
per_page: true

此外,在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)