使用hexo-migrator-wordpress轻松迁移到hexo

前言

静态博客的优势有很多,速度快,安全性高,省心省力。再加上市面上有很多提供免费静态网站托管的服务商(如Github Pages/CF Pages/Netlify/Edgeone Pages等),所以我考虑将我的Wordpress博客迁移到Hexo上,并使用腾讯的EO Pages托管运行,于是便有了这篇文章。

准备工作

首先,准备好一个已经部署好的Hexo博客环境(可以参考Hexo官方文档)做好前置准备。

安装hexo-migrator-wordpress

hexo-migrator-wordpress是一个Hexo插件,可以帮助我们极为方便地将Wordpress博客迁移到Hexo。首先进入Hexo根目录,安装该插件:

1
npm install hexo-migrator-wordpress --save

导出Wordpress数据

该插件需要一个数据源来导入Wordpress数据,所以我们需要先将Wordpress博客的数据导出为XML格式。

登陆Wordpress后台,进入工具-导出

导出1

我该导出什么?

一般情况下建议导出所有内容,如果你的主题是Argon等带“说说”的主题,建议只导出文章和页面,因为导出时说说会被当作文章一起导出,可能会造成不必要的麻烦。

导入到Hexo

导出完成后,将导出的XML文件放到Hexo根目录下,然后执行以下命令:

1
hexo migrate wordpress xxx.xml

其中xxx.xml是你导出的Wordpress数据文件名。执行此操作后,插件会解析XML文件并将数据导入到Hexo中。
如果一切顺利,你应该能看到Hexo根目录下生成了一个_posts文件夹,里面包含了从Wordpress导入的文章。
原来的“页面”会被导出成~/sources/你的页面名称/index.md的形式。

需要注意的是,部分Wordpress主题带有一些自定义的内容,在导出时会导出一些莫名其妙的~/sources/posts/xxx.md,一个显著特征是该文件并没有实际内容,删掉即可。

检查和调整

导入完成后,你需要检查一下导入的内容是否正确。可以跑个预览看下效果:

1
hexo server

发布到GitHub存储库

很多托管商要求你的博客内容被上传到存储库中,所以你需要将Hexo博客内容推送到GitHub存储库中。
按照正常Git发布流程上传就行了。
如果服务商要求你写安装命令和构建命令,如此填写:

1
2
3
4
#安装
npm install
#构建
npm run build

构建目录写/public

为什么选择静态博客?

hexo速度快,安全性高还省心,还能顺带白嫖大厂高速的Pages服务,何乐而不为呢?