博客搭建记录

图片插入问题

Hexo在渲染网页时，会把文章的md文件转换为html格式，而在hexo3中，md在插入图片时需要使用asset标签：

1
2
3

{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}

这并不是md的语法，会导致本地无法阅读图片，以下是目前对我来说最方便的方法。

本地图片插入

我选择将图片文件夹与文章放在同一目录下，插入方式为：

1	![](标题/图片)

Hexo配置

如果使用相同路径，可以在config.yml中打开图片上传配置：

1	post_asset_folder: true

在使用hexo new 文章时会自动在当前目录下生成同名文件夹。

Typora配置

如果使用Typora编辑笔记，可以在文件-偏好设置-图像中配置如下：

粘贴的图片会自动保存在正确的路径。

Hexo路径统一

这里我们需要将asset标签格式转换为md格式，可以先下载插件：

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

如果已经下载了hexo-asset-image而不是这个版本，需要重新下，可以在根目录下package.json中确认插件版本。

此时hexo渲染的输入格式为![](图片)，也就是会在本地渲染格式的基础上多加图片目录，因此需要对插件进行调整，打开/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();
    }
  }
});

即可正常渲染。另外，hexo的渲染插件我使用的是hexo-renderer-marked，在config.yml中添加了如下配置：

1
2
3

marked:
  prependRoot: true
  postAsset: true

更新butterfly

由于主题使用了许多第三方工具，工具的版本迭代有时会产生bug，由于butterfly持续维护，相关问题更新即可解决，记录一下无损更新方法。

直接升级

在hexo的根目录创建文件 _config.butterfly.yml，并把主题目录的 _config.yml 复制到 _config.butterfly.yml 去，只需要在 _config.butterfly.yml配置中进行修改，如果没改主题文件，可以在主题文件夹下直接更新：

git pull

Hexo会自动合并主题中的_config.yml和 _config.butterfly.yml里的配置，如果存在同名配置，会使用_config.butterfly.yml的配置，其优先度较高。

魔改主题升级

魔改主题升级时，直接pull新版本主题文件，新的主题文件会覆盖掉自己的魔改文件。

以下命令操作可保证魔改主题的无损升级：

更新工作的状态树：

git add .

将文件放在堆栈中，获取更新后，再弹栈：

1
2
3

git stash
git pull
git stash pop

git add . 他会监控工作区的状态树，使用它会把工作时的所有变化提交到暂存区，包括文件内容修改(modified)以及新文件(new)，但不包括被删除的文件。

git stash 能够将所有未提交的修改（工作区和暂存区）保存至堆栈中，用于后续恢复当前工作目录。

git stash pop 将当前stash中的内容弹出，并应用到当前分支对应的工作目录上。该命令将堆栈中最近保存的内容删除（栈是先进后出）如果从stash中恢复的内容和当前目录中的内容发生了冲突，那么会提示报错，需要解决冲突，可以通过创建新的分支来解决。

通过git stash将工作区恢复到上次提交的内容，同时备份本地所做的修改，之后就可以正常git pull了，git pull完成后，执行git stash pop将之前本地做的修改应用到当前工作区。