前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >平滑升级魔改后的Hexo主题

平滑升级魔改后的Hexo主题

作者头像
Akilar
发布2021-06-11 11:20:29
1.1K0
发布2021-06-11 11:20:29
举报
文章被收录于专栏:Akilarの糖果屋

写在最前

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

总体思路

本文主要讨论,在大面积魔改了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 Conflictsgit diff 的功能类似但是使用前提依然是不同的,此处如果要使用 Merge Conflicts 来处理,必须确保主题文件夹里的.git 文件夹还在,这样才能有一个 Pull 以后触发 Merge Conflicts 的过程,显然不适用于大多数情况,所以之后的教程依然针对用 git diff 插件处理。) 如果使用的是其他的文本编辑器,例如 VScodeSublimeWebStorm,我不确定它们有没有类似的插件支持,如果有,还请在评论区提醒我更新教程。(按照 Heo 的反馈,可以确定 VScode 也有内置相应的插件。不过考虑到 VScode 和 Atom 的插件作者基本就是同一批人,这个情况也就好理解了。)
  2. 在升级之前,为了保证自己有后悔的余地,务必先行提交一次当前主题配置的源码到 Github 等代码托管站点。若是还不放心,还可以再发布一个 Release。
  1. 在任意位置打开终端,输入以下代码获取最新的稳定版主题文件。
代码语言:javascript
复制
# 两个源,内容完全一样,择一即可。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, 将主题版本号改为最新版本
代码语言:javascript
复制
    {
      "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处理方案归纳

  1. git commit内容是主题文档的git commit history。 严格来说这个不算bug,这是因为点选了主题目录下的文件,且主题目录内的.git文件夹没有删除导致的。Atom自带的git plus插件会自动识别当前文件最深层级目录下的.git文件。最简单的解决方案就是删除主题文件夹下的.git文件夹。也可以打开[Blogroot]\.gitgnore,手动添加themes/butterfly/.git,一劳永逸。
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2020-10-14,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 写在最前
  • 总体思路
  • 理论尝试
  • git diff 插件
  • 升级案例实操
  • 优缺点归纳
  • Bug处理方案归纳
相关产品与服务
内容分发网络 CDN
内容分发网络(Content Delivery Network,CDN)通过将站点内容发布至遍布全球的海量加速节点,使其用户可就近获取所需内容,避免因网络拥堵、跨运营商、跨地域、跨境等因素带来的网络不稳定、访问延迟高等问题,有效提升下载速度、降低响应时间,提供流畅的用户体验。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档