HEXO系列教程 | 发布文章 | 解决静态图片路径错误问题 | 小白向教程

1. 前言

HEXO安装:HEXO系列教程 | 使用GitHub部署静态博客HEXO | 小白向教程

使用YUN主题:

夜梦就在这篇文章中介绍一下如何在HEXO上写文章并发布。你可以直接看官方提供的教程:写作 | Hexo

2. 发写文章

2.1 文件名称

Hexo 默认以标题做为文件名称,但你可编辑 new_post_name参数来改变默认的文件名称。你只需要在_config.yml中修改:

可以使用的占位符:

变量描述例子
:title标题(小写,空格将会被替换为短杠)
:year建立的年份2024
:month建立的月份(有前导零)04
:i_month建立的月份(无前导零)4
:day建立的日期(有前导零)07
:i_day建立的日期(无前导零)7

夜梦这里举个例子,夜梦将默认存储名称修改为 :year-:month-:day-:title.md ,然后就可以很方便地通过日期来管理文章!

2.2. 插入图片相关问题

2.2.1 问题再现

为了避免后续写文章、发布文章的时候遇到图片无法加载的问题,夜梦决定把这一部分写在创建文章之前。如果不进行此部分,你可能在本地预览图片无任何问题,但是上传到Github Pages的时候无法显示,就像下面一样:

夜梦这里提供两个办法来进行图片的插入。

2.2.2 使用图床(推荐)

最推荐的方法其实就是使用图床,这样图片可以正常显示并且不会因为本地资源的调整而出现问题。因为GitHub网络问题,如果上传过多的图片到GitHub中,加载hexo可能会很慢。使用图床就可以很好地解决这个问题。

你可以使用腾讯云、阿里云的对象存储服务存储图片,然后在文章中加入图片的链接。除了腾讯云、阿里云等,夜梦还推荐使用雨云的对象存储服务,价格如下:

  • 流量:套餐内每GB 0.2 元,套餐外每GB 0.5 元。
  • 存储:套餐内每GB 0.05 元,套餐外每GB 0.12 元。

最低13元/月即可获得100G存储+25G流量或者是5G存储+50G流量套餐。如果关闭弹性计费,就不会产生额外费用,不用担心被攻击以后产生的天价账单。

雨云优惠注册链接(长期九折+首月五折优惠):https://www.rainyun.com/

2.2.3 修改配置与安装插件

你也可以通过修改配置并安装插件的方法完成图片的插入。你需要修改站点配置_config.yml,将post_asset_folder设置为true,如下图:

然后安装插件:

npm install hexo-asset-image -- save

2.2.4 修复静态图片路径

如果你使用的是插件,当生成预览的时候,可能依旧无法正常查看图片。

通过直接查看HTML文件,我们可以看到是因为多了/.com/,所以在加载图片的时候无法获得正确的路径。

具体的修改也很简单,我们只需要到node_modules中找到hexo-asset-image,并将58、89行的

修改为:

$(this).attr('src', src);
console.info && console.info("update link as:-->" + src);

如下图:

不出意外的话,就可以看到正常显示的图片了:

2.3 创建文章

在HEXO目录下,打开GIT BASH HERE,你可以直接使用下面的命令创建新的文章:

# 标准格式如下
# hexo new post <title>
# 夜梦这里举例
hexo new post HEXO博客的初步使用

创建完成,可以在终端里面看到提示:

文章post的存储路径:source/_posts。因为我们安装了插件,所以在同一目录下,会生成一个和文章名字一样的文件夹。

2.4 写作

写作就很简单了,在.md文件里面直接用markdown语法写就可以了。

如果需要引用本地图片地话,需要把图片放到我们只需要把图片放到与文章同名的文件夹中,然后直接引用~

![yourDescription](yourPostTitle/yourImage.png) # 假如你的文章名是yourPostTitle,图片名字是yourImage.png

3. 发布

写完以后保存.md文件,然后运行

hexo clean && hexo g && hexo s

本地预览。无误后,你可以执行

hexo d

发布到github pages上。夜梦演示的效果如下图:

4. 注意事项

在写文章的时候,文章head里面的每个项目后面都要加空格,要不然会报错哦!

5. 其他HEXO教程推荐

配置 YUN 主题:

安装HEXO:

本文为夜梦星尘原创文章。
文章作者:夜梦星尘
文章链接:HEXO系列教程 | 发布文章 | 解决静态图片路径错误问题 | 小白向教程
版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来自夜梦星尘
支持作者:夜梦星尘的爱发电
上一篇
下一篇