时隔 2 年的时间后，如今又再一次开始折腾自己的博客站点，看来是自己有点太躁动啦😂。在上海疫情期间也真有点压抑的，为了消除这份不安的情绪，决定参考 Hexo NexT 从零开始全面重构 NexT 主题，也在独自奋斗的2个多月断断续续时间里完成主体功能所有移植工作（其实一直想有人参与进来共建，直接跑到人家 Hexo NexT 用户群“呼喊”，但也是没有浪花泛起，只好是自己继续独立前行）。 这不乘着周末的时间，把自己的站点也是升级到最新开发的主题，同时也是为后续想升级旧版本 Hugo NexT 的用户打个样吧。

注意： 以下的操作记录，如果你已经熟悉 Hugo 使用，了解 Hugo NexT 主题相关配置，那么效果会更加好。 不熟悉也没有关系，你可以克隆 hugo-next-docs 项目进行参考，相信你会有所收获！ ✊ 😄

配置更新

首先声明一下配置文件已经和旧版本完全不兼容，因此在配置主题时无须参考原来的配置，只须根据新版本主题提供 示例配置文件 里面的注释说明调整自己站点信息即可，如站点名称，标题，头像，菜单，评论等个性化设置。

主题默认提供的是单一配置文件的经典模式，可能很多人都会比较喜欢这样的简便风格，但个人还是更喜欢 Hugo 那种按目录进行分类管理的形式，不仅方便于管理，而且在本地开发时能效的屏蔽某些配置参数泄漏，整体的目录结构参考如下：

config
├── _default        # 默认生产发布的配置文件
│   ├── config.yaml # Hugo 引擎配置参数
│   ├── menus.yaml  # 站点菜单项
│   └── params.yaml # 各类效果，组件参数配置
└── development     # 本地开发预览的配置文件（不上传到代码仓库）

当在本地运行 hugo server 命令预览站点时，会读取 development 文件夹里的参数配置。而当运行 hugo 命令生成全站静态文件时，会默认读取 _default 文件夹里的参数配置，这便实现开发环境与部署环境相互隔离，互不影响的完美效果！

注： 如果是从 Hexo 迁移过来的用户，那么本主题的配置文件兼容性可达 90% 以上 👍 。

文章拷贝

文章内容这块的默认情况下是无须任何的调整，新版本的主题文章头部参数设置与旧版主题是保持向下兼容的，包括之前是应用其他主题的文章也可以兼容（因为用的是标准的 FrontMatter 参数），因此一般情况下只要拷贝到 content 目录下相同的位置即可。

不过自己又稍微折腾了一下，原因是之前的文章都是在 content\posts 一个目录中并没有做好分类管理，想通过此次的升级重新整理下文章的分类，而且新版本的主题中已经可以支持多个自定义目录。另外之前的文章链接中都是带有日期想进一步缩短链接长度，而且也发现 Hugo 中有 aliases 功能特别的强大，无需担心之前 SEO 的链接无法正常访问，语法参考如下：

title: "让 Nginx 将 HTTP 请求转发到 HTTPS 安全模式"
# 新的链接地址
url: blog/make-nginx-support-http-ssl-request.html
# 旧的链接地址
aliases:
  - /2022/05/05/make-nginx-support-http-ssl-request.html

因此也用 Python 写了个小脚本进行自动生成新的链接地址，代码参考如下：

def append_alias_fm(source, target):
  """在原来的博客文章中添加新的 aliases 变量
  :param source: 原始目录
  :param target: 目标目录
  """
  for root,dirs,files in os.walk(source):
    folders = root.split('\\');
    t_sub_folder = ''
    if len(dirs) == 0 and len(folders)>0:
      t_sub_folder = folders[1]
      t_sub_folder_path = os.path.join(target, t_sub_folder)
      if not os.path.exists(t_sub_folder_path):
        os.makedirs(t_sub_folder_path)
      print("Current Folder: %s" % t_sub_folder)
    for file in files:
      with open(os.path.join(target, t_sub_folder, file), "wb+") as tf:
        with open(os.path.join(root, file), "rb+") as sf:
          print("Current File: %s" % os.path.basename(sf.name))
          while True:
            try:
              line = sf.readline()
              line_splits = line.decode().splitlines()
              if len(line_splits) <= 0:
                break;
              line_str = line_splits[0]
              if 'url' in line_str:
                old_url = line_str.split(': ')[1]
                new_url = old_url.split('/')[3]
                if '"' in old_url:
                  old_url = old_url.strip('"')
                  new_url = new_url.strip('"')
                tf.write(('url: blog/'+ new_url + '\r\n').encode())
                tf.write(('aliases: \r\n  - /'+ old_url + '\r\n').encode())
                tf.write(sf.read())
                break
              else:
                tf.write(line)
            except:
              print('Somethings wrong!!!')
              traceback.print_exc()
              break

修改后的文章经过测试都能正常的访问，发布上线后，通过搜索引擎检索到的旧链接地址都能正常的访问，并成功跳转到新的链接地址，不过为了 SEO 更加友好，还是同步把新的 sitemap.xml 文件重新提交给各个搜索引擎。

评论迁移

相比文章拷贝来说评论迁移就比较繁琐些，本博客一直使用的都是 Waline 评论插件，它提供了一个导入导出的功能，原以为只是将原文章地址进行替换后导入就可以。但结果是草率了，修改后的文件导入居然失败了，然后尝试换成了 LeanCloud 官方的导入功能便成功，本以为迁移工作到此就结束了，结果又来了如下问题：

Post Comment Error

真是无语至极呀，还好之前也处理过类似的情况，接着就又对数据一阵“魔改”，终于是搞定好了天下太平，评论功能也总算是恢复正常，自己发个板凳留念下。

在线搜索

新版本的主题支持 Alogia 在线搜索引擎，观察过不少站点（特别是一些文档类的网站都在使用），开发主题时也体验了下它的功能，觉得还是蛮不错的，搜索和响应速度也挺快的。 开发好后集成也是相对比较简单，只是多了个注册和上传索引文件的操作。原以为索引是自动根据站点路径生成，还好 Github 提供了 CI 支持，可以省去上传这步操作，直接实现流程的全自动化。 这里使用的是 Github Action 功能，脚本参考如下：

 - name: Upload Algolia Indexes
    env:
      ALGOLIA_APPID: ${{ secrets.ALGOLIA_APPID }}
      ALGOLIA_ADMINKEY: ${{ secrets.ALGOLIA_ADMINKEY }}
      ALGOLIA_INDEXNAME: ${{ secrets.ALGOLIA_INDEXNAME }}
      ALGOLIA_INDEXFILE: "./public/algolia.json"
    run: |
      npm install --location=global @algolia/cli
      algolia import -s $ALGOLIA_INDEXFILE -a $ALGOLIA_APPID -k $ALGOLIA_ADMINKEY -n $ALGOLIA_INDEXNAME

相比较于本地搜索功能，Algolia 还提供搜索分析的数据报告，能更好的帮你观测自己的站点和用户搜索行为。

发布测试

一切准备就绪那么接下来就发布上线，同样的原则能够自动化的坚决不手动，利用 Github Action 提供的功能，实现站点静态文件自动编译，发布等操作。还有一步重要的同步备份流程不能忘呀，也算是安全意识的一部分吧，便于后续不时之需，所以个有习惯把代码都同步到 Gitee 仓库，而且有网友开发 Gitee Pages 的刷新功能，又再次避免手动操作的麻烦，相当于是一次同时发布了 2 个站点，参考脚本如下：

# 同步到 Gitee 代码仓库备份
  sync-2-gitee:
    needs: deploy-site
    runs-on: ubuntu-latest
    steps:
      - name: Sync Site Source
        uses: wearerequired/git-mirror-action@master
        env:
          SSH_PRIVATE_KEY: ${{ secrets.RSA_PRIVATE_KEY }}
        with:
          source-repo: git@github.com:elkan1788/myblog-sources.git
          destination-repo: git@gitee.com:lisenhui/myblog-sources.git

      - name: Sync Site Build
        uses: wearerequired/git-mirror-action@master
        env:
          SSH_PRIVATE_KEY: ${{ secrets.RSA_PRIVATE_KEY }}
        with:
          source-repo: git@github.com:elkan1788/elkan1788.github.io.git
          destination-repo: git@gitee.com:lisenhui/lisenhui.git

  # 刷新 Gitee Page 服务（备份站点）
  reload-pages:
    needs: sync-2-gitee
    runs-on: ubuntu-latest
    steps:
      - name: Build Gitee Pages by GitAction
        uses: yanglbme/gitee-pages-action@main
        with:
          gitee-username: ${{ secrets.GITEE_USERNAME }}
          gitee-password: ${{ secrets.GITEE_PASSWORD }}
          gitee-repo: lisenhui/lisenhui
          branch: main

后续计划

对比了下旧版本主题的编译速度，迁移至新主题后效率直接提升 4 倍以上，再配合 Hugo 引擎的性能表现，本博客现有的 270 个页面生成只需要 600ms ，结果就是一个字 “快”，也呼吁大家尽早迁移到新版本的主题上使用，不仅能享用新功能，还可以体验下那“快感”😄。 后面也会持续做好站点生成速度的优化，尽可能的提升到极限😁。

也希望能够吸引到更多的小伙伴们，一起参与进来共同建设 Hugo NexT 主题。

除了主题的开发工作外，也会做好博客内容的打造。 在此也感谢 杜老师 的“引荐”，才知道原来还有个叫做 十年之约 的博客友人们组织。 自己现也是 入会十年之约 ，算是给自己立的 🚩，也相信自己能在博客运营上面一直地坚持下去。🎉