Hexo-GitHub Pages解决上传文章图片不显示的问题

前言

在自己搭建的网站写好文章以后，上传到GitHub上发现文章中的图片无法显示。这个问题改了很长时间，所以在这里记录最后有效的方法。

问题表现

自己在Typora中黏贴进去的图片，无论是预览还是部署以后都无法显示，上图为预览中的样子。

当我部署在GitHub上我在控制台中查看图片的位置，竟然是在wsj.github.io/1.png，图片的位置跑到了根目录下，显然路径位置不对。

解决方法

插件安装与配置

首先使用一个图片路径转换的插件hexo-asset-image，安装指令如下：

npm install https://github.com/CodeFalling/hexo-asset-image --save
# npm install hexo-asset-image --save

安装好之后，需要打开node_modules/hexo-asset-image/index.js，将其中的代码更换，如下：

'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();
    }
  }
});

之后，打开站点配置文件_config.yml，修改：

post_asset_folder: true

这个指令的作用就是当你使用hexo new “article name”创建一篇新的文章时，可以自动在_post中生成一个与article name同名的文件夹，用于存放图片。当然，手动创建article name.md和article name文件夹也是可以的。注：但是对于解决文本的问题，post_asset_folder的设置是必须的，因为上文提到的插件，必须在post_asset_folder为true的情况下使用。