解决hexo引用本地图片无法显示的问题
前言
最近学习hexo搭建个人博客,陆续搭建了next主题,在打算插入图片的时候出现了图片失效的问题,查看index.html文件,发现图片路径出现了莫名其妙的.com,然后发现插件是2018年的,已经好久没有更新了。
无论官方文档给出的示例
1 2 | {% asset_img example.jpg This is an example image %} 还是使用 volantis主题文档 给的代码 |
1 | {% img [class names] /path/to/image [width] [height] '"title text" "alt text"' %} |
同样无法正常使用,花费了许久时间才解决这个问题。 因此将一些解决经验整理出来,希望能帮助到大家。
解决步骤
打开_config.yml文件,修改下述内容,目的是为了新建文章时自动帮我们建一个与文章名相同的文件夹用来从放图片文件
post_asset_folder: true
我们需要安装一个图片路径转换的插件,这个插件名字是hexo-asset-image
1 2 3 | npm install hexo-asset-image --save 图片无法显示的问题就出在这个插件的代码之中 |
打开/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 | '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语法插入图片就一切正常了。