鱼塘

好多好多好多鱼

0%

Hexo博客图片加载路径出错BUG解决

换电脑后新搭了一遍博客,测试发现博客中图片路径出错。使用检查后发现图片路径出错了,路径中进行图片路径中的 ‘\’ 被转换成为 ‘%5C’,导致生成的图片路径无法识别。问题出在 hexo-asset-image 插件上。在经历一番查找后,发现该插件确实有 BUG,网上也有一些帖子提出了相关的问题及解决方案。但是问题多种多样,不一定适合自己,在此附上自己的解决方法,提供一种解决问题的思路,如遇相关问题可以自行修改代码。

遇到问题

image-20200418142714321

可以看到,图片路径中原本应该为 ‘/’ 的字符被转换成了 ‘%5C’。

修改问题

发现问题之后就马上对 hexi-asset-images 插件进行修改,路径为 yourblog/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
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
'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;
}

hexo.extend.filter.register('after_post_render', function(data){
var config = hexo.config;
if(config.post_asset_folder){
var link = data.permalink;

var beginPos = getPosition(link, '/', 3) + 1;
var appendLink = '';
// In hexo 3.1.1, the permalink of "about" page is like ".../about/index.html".
// if not with index.html endpos = link.lastIndexOf('.') + 1 support hexo-abbrlink
if(/.*\/index\.html$/.test(link)) {
// when permalink is end with index.html, for example 2019/02/20/xxtitle/index.html
// image in xxtitle/ will go to xxtitle/index/
appendLink = 'index/';
var endPos = link.lastIndexOf('/');
}
else {
var endPos = link.length-1;
}
link = link.substring(beginPos, endPos) + '/' + appendLink;

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 '/'.

// 修改了这一句,添加了将 ‘%5C’ 替换为 ‘/’ 的处理
// 如遇到类似的情况,可自行参将代码进行修改
// 启用 console.info 查看修改前和修改后的路径区别
// console.info&&console.info("src1:-->"+$(this).attr('src').replace('\\', '/'));
var src = $(this).attr('src').replace('\\', '/').replace(/%5C/g, '/');
// console.info&&console.info("src2:-->"+src);

if(!(/http[s]*.*|\/\/.*/.test(src)
|| /^\s+\//.test(src)
|| /^\s*\/uploads|images\//.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);
// console.info&&console.info("update link as:-->"+src);
}
}else{
console.info&&console.info("no src attr, skipped...");
console.info&&console.info($(this));
}
});
data[key] = $.html();
}
}
});

这类问题只要定位到时哪里出的错,其它就比较好解决。