博客主题更换

之前用的博客主题太久没更新,已经无法使用hugo编译,而且也不支持搜索,所以抽空更换了一下主题。

目前在用的是FixIt,功能比较全面,这里记录一下迁移日志。

之前用的hugo主题管理,这次改成了git submodule. hugo的主题管理会导致主题相关文件与其他目录混在一起,将来更换主题的时候就很麻烦。submodule的方式可以确保主题在单独的theme文件夹里,只需要更新根目录下面的hugo.toml即可完成配置。

清理

原来项目目录下的config、docs、archtypes、resources文件夹都可以删了,go.mod/go.sum/package.json/*.lock 这些hugo管理时会生成的文件也要删掉。之前的核心配置文件config/_default/config.yaml记得备份一下,里面的配置还有用。

安装

安装过程请参考FixIt官方文档,需要注意的是submodule默认获取的是main分支的最新代码,是不稳定的。需要进入子目录后使用git checkout到一个稳定的版本,比如git checkout v0.3.20

配置

参考官方指南,将theme下面的hugo.toml copy到根目录下,根据自己的情况修改。

评论区建议从github issue切换到github disscussion(giscus),issue看着有点奇怪,而且还可以手动创建。

其他的没啥好说的,配置项非常多,搜索配置fuse即可。

左侧如果想打开合集(collections),需要手动配置一下,不过我这里都是直接更新合并到一个文件里面了。

部署

之前是直接用docs文件夹部署,这次按官方指南用actions部署,需要去settings-page里面切换一下部署方式。然后在项目.github/workflows里面新建一个yaml文件,直接把hugo官方github pages部署脚本粘贴进去就完事。

网上找到的很多脚本都过时了,直接用最新的官方脚本就可以,唯一需要修改的可能是branch的名字。

旧有博客迁移

之前博客原始md丢失了,只有hugo build的文件夹,这次一起迁移了。

使用python3 -m http.server 1313,在对应页面建立服务器,进去挨个复制(用typro)粘贴成md文件。

手动修改frontmatter里面的date和lastmod,即可。

一些过时的技术博客就放弃了,没有再迁移。

0%