平滑升级魔改后的Hexo主题

写在最前

这里仅仅讨论同一大版本之间的主题升级，跨版本升级用户若使用本文的方式，很可能因为缺少一些底层架构的依赖支持导致主题配置不可用。另外，从博主本人的魔改历程来看，考虑到魔改内容也未必会做新版本的兼容适配，所以每次升级后直接从零开始重新魔改，这种看似最麻烦的方式，可能是最省时间的。

总体思路

本文主要讨论，在大面积魔改了Hexo主题之后，如何平滑升级到最新版本的主题。众所周知，如果是按照主题文档的说法，使用git pull，那么从远端拉取的新版主题会覆盖现有的魔改主题，这显然不是我们想要的结果。那么不妨换个思路，既然升级这个过程本质上就是对上一版本的主题代码进行修改，我们为啥不直接把这次升级看作是对上一版本主题的一次大魔改呢？

理论尝试

Github 本身就提供了 Compare 的功能，在 Release 的左侧。

点选当前版本相对于另一版本修改的内容。

由此就能看出升级前后的文件异同。

但是，这个方案最多只适用于小版本更新，例如 10 个文件以内的修改。一旦涉及到整体结构变更的大版本更新，很显然单纯的通过比较以后逐个去修改，同时还要记忆自己魔改的内容与新版主题的冲突。正常人类的精力是不足以应对这种局面的。这里，可以再尝试一下另一种思路。

git diff 插件

Github 除了上面提到的 Compare 功能以外，还有一个叫做 Pull requests 的功能，这个功能的本意是在协同开发时提供合并多个分支的操作。也就是说，我们完全可以将新主题的配置作为一个新的分支提交到 github，然后在 github 发起该分支到魔改版本分支的 Pull requests。然后在 Pull requests 逐个处理合并冲突。本文提供的最终的方案就是基于这一原理来进行的。使用 Atom 自带的 git diff 插件，能够快速的在图形化界面中处理合并冲突。

升级案例实操

以 butterfly 主题升级为例

1. 首先你需要安装 Atom，详细的安装教程以及插件配置可以参考这篇文章：Atom 插件安装和推荐。 原本还需要安装 Merge Conflicts 插件，但是最新版 Atom 已经将该插件的功能集成在默认插件的 git diff 中。 （Merge Conflicts 和 git diff 的功能类似但是使用前提依然是不同的，此处如果要使用 Merge Conflicts 来处理，必须确保主题文件夹里的.git 文件夹还在，这样才能有一个 Pull 以后触发 Merge Conflicts 的过程，显然不适用于大多数情况，所以之后的教程依然针对用 git diff 插件处理。） 如果使用的是其他的文本编辑器，例如 VScode、Sublime、WebStorm，我不确定它们有没有类似的插件支持，如果有，还请在评论区提醒我更新教程。（按照 Heo 的反馈，可以确定 VScode 也有内置相应的插件。不过考虑到 VScode 和 Atom 的插件作者基本就是同一批人，这个情况也就好理解了。）
2. 在升级之前，为了保证自己有后悔的余地，务必先行提交一次当前主题配置的源码到 Github 等代码托管站点。若是还不放心，还可以再发布一个 Release。

1. 在任意位置打开终端，输入以下代码获取最新的稳定版主题文件。

# 两个源，内容完全一样，择一即可。gitee在国内较快。
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git butterfly #github源
git clone -b master https://gitee.com/iamjerryw/hexo-theme-butterfly.git butterfly #gitee源

1. 找到你的 Hexo 源码，删除[blogroot]/themes 目录下的 butterfly 主题文件夹，然后将刚刚 clone 的最新的 butterfly 主题文件夹移动到 [blogroot]/themes 目录下。同时记得删除 [blogroot]/_config.butterfly.yml, 同时将最新的 butterfly 主题文件夹内的_config.yml 文件复制并重命名为_config.butterfly.yml 后移动到 [blogroot]/ 目录下。恭喜你，现在你可以重新开始魔改之旅了！ 说白了就是删除现有主题的一切内容，然后移入新版主题。相当于从零开始，当然不会真的从零开始。 也可以选择直接覆盖。但是考虑到 butterfly 主题的更新偶尔会把主题内的 js 和 css 资源转为 CDN，而覆盖操作并不会删除主题文件夹内的相应静态资源。 所以还是建议直接删除原版主题后再移入新版主题文件夹比较好。
2. 使用 Atom 打开 Hexo 项目文件夹

在右下角找到 git 按钮，打开 Atom 自带的 git plus 的 GUI 界面。

1. 点选 Unstaged Changes 内的内容打开 git diff 处理界面。

注意保留修改和删除修改的前后项，如果是先删除了原版主题文件夹然后再移入新版主题文件夹，那么点选保留修改是接受新版主题的新增内容，点选删除修改是保留原版主题的内容。前后概念理清有助于你在之后处理合并的内容。

1. 合并处理完成后运行 hexo clean & hexo g & hexo s 就可以在本地预览薛定谔的报错更新后的内容了。
2. 最后一步，打开 [Blogroot]/themes/butterfly/package.json, 将主题版本号改为最新版本

    {
      "name": "hexo-theme-butterfly",
-     "version": "3.1.1",
+     "version": "3.2.0",
      "description": "A Simple and Card UI Design theme for Hexo",
      "main": "package.json",
      "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
      },

优缺点归纳

Bug处理方案归纳

1. git commit内容是主题文档的git commit history。 严格来说这个不算bug，这是因为点选了主题目录下的文件，且主题目录内的.git文件夹没有删除导致的。Atom自带的git plus插件会自动识别当前文件最深层级目录下的.git文件。最简单的解决方案就是删除主题文件夹下的.git文件夹。也可以打开[Blogroot]\.gitgnore,手动添加themes/butterfly/.git，一劳永逸。