博客平台由 WordPress 转入 Hugo
By 辞峡烟斜
前段时间因为 WordPress 平台无缘无故发生的代码高亮问题,还有考虑数据备份方便的需求(数据库比较脆弱,出了问题恢复数据太费时费力),一度想把本站博客平台从 WordPress 切换到纯静态博客网站。从众多静态网站生成器中,我选择了 Hugo,主要是大众口碑好。历经一两个月地“苦啃” Hugo 文档,终于也是收效甚微,还是重拾老一套,在前一辈的挖坑埋坑经历中找寻适合自己的路,沿着众多大侠走过的路,终于是改好了模板,并成功于9月30日将本博客网站切换至使用 Hugo 生成静态网站。以下记录过程:
导出 WordPress 日志原文
原有日志虽然质量不咋地,没什么使用价值,但也是自己十多年来的“辛勤劳作”,弃之可惜,还是拾之可闻味。有大神提供了导出工具WordPress to Hugo Exporter,请参看《博客从迁移Wordpress到Hugo》操作。
简单来说,就是将WordPress to Hugo Exporter插件文件夹安装在WordPress的插件目录wp-content/plugins/下,启用之,按提示操作即可。如出错误 Class 'ZipArchive' not found
, 则先 aptitude install php-zip
。通过 WordPress 后台插件操作,我是没成功,最是还是在服务器终端执行php hugo-export-cli.php
搞定,建议在终端下操作导出。
导出的博文 markdown 源码文件不甚完美,有些地方需要自己修改,不过也是可以了,省去了自己很大工作量。
安装 Hugo
Hugo官方网站:https://gohugo.io/
Hugo Github网站:https://github.com/gohugoio/hugo
从Hugo Github网站 下载最新版本。
如是 deb 系统,可以用命令 wget https://github.com/spf13/hugo/releases/download/v0.14/hugo_0.14_amd64.deb
下载。用sudo dpkg -i hugo*.deb
安装。
对于最新版本的 debian ,可以直接在终端运行aptitude install hugo
安装。
成功安装后,运行 hugo version
,将会打印其当前的软件版本,譬如显示:
Hugo Static Site Generator v0.14 BuildDate: 2015-05-25T21:29:16-04:00
表示 Hugo 安装成功!
Hugo 学习教程
Hugo 由浅入深学习以及主题的修改,可以参考以下文章:
- https://blog.olowolo.com/post/hugo-quick-start/
- https://segmentfault.com/a/1190000016679032
- http://blog.wikty.com/posts/hugo/hugo_directory_structure/
- http://www.g-var.com/posts/translation/hugo/hugo-1-introduction/
- https://segmentfault.com/a/1190000016078760
选用主题
Hugo 官方主题站 https://themes.gohugo.io/ 提供了很多主题,可以根据自己喜好挑选相应主题,参看某一主题安装说明安装即可。 个人比较中意的主题:
- mainroad主题:https://themes.gohugo.io//theme/mainroad/
- hugo-universal主题:
- hugo-univeral 主题官方站:https://themes.gohugo.io/hugo-universal-theme/
- hugo-univeral 主题概览:https://jimmysong.io/hugo-handbook/themes/hugo-universal-overview.html
- Hugo Universal 主题使用指南:https://jimmysong.io/posts/hugo-universal-theme-guide/
- AllinOne主题:
- AllinOne 主题作者 Blog 站:https://orianna-zzo.github.io/
- AllinOne 主题作者 Blog 站源码:https://github.com/orianna-zzo/blog-hugo
- AllinOne 主题Github:https://github.com/orianna-zzo/AllinOne
- pcaman主题:
- pcaman主题Github:https://github.com/coderzh/hugo-pacman-theme
- pcaman主题介绍:https://3mile.top/archives/119/
- pcaman主题演示地址:http://coderzh.github.io/hugo-pacman-theme/
主题修改定制
一开始选定了 Orianna 的 AllinOne 主题,也确实根据自己需要修改完善差不多了,后来感觉有些花哨,弃之不用,能简单一点就简单吧。以下是修改 AllinOne 主题的“成果”:




最终暂时选定用 pcaman 主题,定制修改可是费了老大劲。不明白的,一查官方文档,二查前人的经验文档。个人定制还不是那么如意,先用起来再说。于是成就了我现在的 Hugo 静态博客站点:

截图了之前 WordPress 平台博客页面,以示回忆记念:




VPS 部署站点
通过以上过程的学习和实践,利用 Hugo 生成静态网站应该相对来说比较熟练了。博客最终要发布,要部署到服务器上。当然可以手动拷贝生成的 Publish 目录到 Web 服务器,但是未免繁琐了点,完全可以用 Git 搞定,自动提交修改过的文章和内容,非常方便。这方面内容可以参考在VPS上结合Git使用hugo搭建静态博客实现,在此不作具体说明。