遇到Hexo图片无法显示的问题,刚开始觉得只是小事,没太在意。但解决起来却出乎意料地费劲,最终参考了某位博主的方法,问题得以解决。

前言

最近尝试了一个新的方法,将图片放在与Hexo博客同名的文件夹下,并通过简洁的方式在博客中引用。我已经安装了hexo-asset-image插件,同时将post_asset_folder设置为true,但无论是使用![](img.jpg)的格式还是{% asset_img example.jpg This is an example image %}的格式,图片都无法正常显示。为了解决这个问题,我在谷歌上搜索了很久,终于找到了解决方案,成功解决了这个问题。

解决步骤

  1. 打开_config.yml文件,修改以下内容的目的是为了在新建文章时自动创建一个与文章名相同的文件夹,方便存放相关图片文件。
1
post_asset_folder: true
  1. 为了实现图片路径的转换,我们需要安装一个名为hexo-asset-image的插件。
1
npm install hexo-asset-image --save
  1. 打开/node_modules/hexo-asset-image/index.js文件,并将其中的内容替换为下面的代码。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
'use strict';
var cheerio = require('cheerio');

// http://stackoverflow.com/questions/14480345/how-to-get-the-nth-occurrence-in-a-string
function getPosition(str, m, i) {
return str.split(m, i).join(m).length;
}

var version = String(hexo.version).split('.');
hexo.extend.filter.register('after_post_render', function(data){
var config = hexo.config;
if(config.post_asset_folder){
var link = data.permalink;
if(version.length > 0 && Number(version[0]) == 3)
var beginPos = getPosition(link, '/', 1) + 1;
else
var beginPos = getPosition(link, '/', 3) + 1;
// In hexo 3.1.1, the permalink of "about" page is like ".../about/index.html".
var endPos = link.lastIndexOf('/') + 1;
link = link.substring(beginPos, endPos);

var toprocess = ['excerpt', 'more', 'content'];
for(var i = 0; i < toprocess.length; i++){
var key = toprocess[i];

var $ = cheerio.load(data[key], {
ignoreWhitespace: false,
xmlMode: false,
lowerCaseTags: false,
decodeEntities: false
});

$('img').each(function(){
if ($(this).attr('src')){
// For windows style path, we replace '\' to '/'.
var src = $(this).attr('src').replace('\\', '/');
if(!/http[s]*.*|\/\/.*/.test(src) &&
!/^\s*\//.test(src)) {
// For "about" page, the first part of "src" can't be removed.
// In addition, to support multi-level local directory.
var linkArray = link.split('/').filter(function(elem){
return elem != '';
});
var srcArray = src.split('/').filter(function(elem){
return elem != '' && elem != '.';
});
if(srcArray.length > 1)
srcArray.shift();
src = srcArray.join('/');
$(this).attr('src', config.root + link + src);
console.info&&console.info("update link as:-->"+config.root + link + src);
}
}else{
console.info&&console.info("no src attr, skipped...");
console.info&&console.info($(this));
}
});
data[key] = $.html();
}
}
});

随后,使用Markdown语法插入图片就一切正常了。

参考链接

  1. https://juejin.cn/post/7006594302604214280img