平滑升级魔改后的Hexo主题
写在最前
这里仅仅讨论同一大版本之间的主题升级，跨版本升级用户若使用本文的方式，很可能因为缺少一些底层架构的依赖支持导致主题配置不可用。另外，从博主本人的魔改历程来看，考虑到魔改内容也未必会做新版本的兼容适配，所以每次升级后直接从零开始重新魔改，这种看似最麻烦的方式，可能是最省时间的。
总体思路
本文主要讨论，在大面积魔改了Hexo主题之后，如何平滑升级到最新版本的主题。众所周知，如果是按照主题文档的说法，使用git pull，那么从远端拉取的新版主题会覆盖现有的魔改主题，这显然不是我们想要的结果。那么不妨换个思路，既然升级这个过程本质上就是对上一版本的主题代码进行修改，我们为啥不直接把这次升级看作是对上一版本主题的一次大魔改呢？
理论尝试
Github 本身就提供了 Compare 的功能，在 Release 的左侧。
点选当前版本相对于另一版本修改的内容。
由此就能看出升级前后的文件异同。
但是，这个方案最多只适用于小版本更新，例如 10 个文件以内的修改。一旦涉及到整体结构变更的大版本更新，很显然单纯的通过比较以后逐个去修改，同时还要记忆自己魔改的内容与新版主题的冲突。正常人类的精力是不足以应对这种局面的。这里，可以再尝试一下另一种思路。
git diff 插件
Github 除了上面提到的 Compare 功能以外，还有一个叫做 Pull requests 的功能，这个功能的本意是在协同开发时提供合并多个分支的操作。也就是说，我们完全可以将新主题的配置作为一个新的分支提交到 github，然后在 github 发起该分支到魔改版本分支的 Pull requests。然后在 Pull requests 逐个处理合并冲突。本文提供的最终的方案就是基于这一原理来进行的。使用 Atom 自带的 git diff 插件，能够快速的在图形化界面中处理合并冲突。
升级案例实操
以 butterfly 主题升级为例
- 首先你需要安装 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 的插件作者基本就是同一批人，这个情况也就好理解了。） - 在升级之前，为了保证自己有后悔的余地，务必先行提交一次当前主题配置的源码到 Github 等代码托管站点。若是还不放心，还可以再发布一个 Release。
- 在任意位置打开终端，输入以下代码获取最新的稳定版主题文件。
# 两个源，内容完全一样，择一即可。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源- 找到你的 Hexo 源码，删除
[blogroot]/themes目录下的butterfly主题文件夹，然后将刚刚 clone 的最新的butterfly主题文件夹移动到[blogroot]/themes目录下。同时记得删除[blogroot]/_config.butterfly.yml, 同时将最新的butterfly主题文件夹内的_config.yml文件复制并重命名为_config.butterfly.yml后移动到[blogroot]/目录下。恭喜你，现在你可以重新开始魔改之旅了！说白了就是删除现有主题的一切内容，然后移入新版主题。相当于从零开始，当然不会真的从零开始。 也可以选择直接覆盖。但是考虑到 butterfly 主题的更新偶尔会把主题内的 js 和 css 资源转为 CDN，而覆盖操作并不会删除主题文件夹内的相应静态资源。 所以还是建议直接删除原版主题后再移入新版主题文件夹比较好。 - 使用 Atom 打开 Hexo 项目文件夹
在右下角找到 git 按钮，打开 Atom 自带的 git plus 的 GUI 界面。
- 点选
Unstaged Changes内的内容打开 git diff 处理界面。
注意保留修改和删除修改的前后项，如果是先删除了原版主题文件夹然后再移入新版主题文件夹，那么点选保留修改是接受新版主题的新增内容，点选删除修改是保留原版主题的内容。前后概念理清有助于你在之后处理合并的内容。
- 合并处理完成后运行
hexo clean & hexo g & hexo s就可以在本地预览薛定谔的报错更新后的内容了。 - 最后一步，打开 [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"
},优缺点归纳
优点 | 缺点 |
|---|---|
直接通过GUI界面进行合并冲突处理，较为直观 | 修改者对于自己魔改的内容需要一定的记忆 |
最终效果等同于从零开始重新进行了一遍魔改 | 某种程度上还不如从零开始重新魔改来的轻松 |
适合大版本内进行更新 | 跨版本升级可能因为缺少相应依赖引发报错 |
Bug处理方案归纳
- git commit内容是主题文档的git commit history。
严格来说这个不算bug，这是因为点选了主题目录下的文件，且主题目录内的
.git文件夹没有删除导致的。Atom自带的git plus插件会自动识别当前文件最深层级目录下的.git文件。最简单的解决方案就是删除主题文件夹下的.git文件夹。也可以打开[Blogroot]\.gitgnore,手动添加themes/butterfly/.git，一劳永逸。