网站已经迁移了一个多月,一直想写下,但是因为一个issue的问题,一直不爽快:
the tag format
一直想等待解决再来写。
周末抽空过了一遍代码,代码中是用spyc来生成yaml的。改成[xx, x] 的格式还是要费点神的,而且破坏了原来格式的简单优美,什么意思?看下两种格式的生成就明白了,前者是不用考虑长度的迭代模式,后者要考虑长度,因为要在结尾加后括号']',这样逻辑就不是简单流式的了。为了确认是否值得修改,确认了官方的文档:
yaml官方文档
发现2种格式都是支持的,但是hugo的问题是:
文档的tags和categories本质来讲,都是列表数组,没有道理两种采用不同的格式,详情:
the tag format advice
显然关闭的人并没有理解我的意思,但是还是有其他的开发者明白了我的意思,做了回复,总之此问题目前确认是属于hugo的“不优雅”。不打算勉强,为了修复而修复,静待hugo的变化吧。
hugo
hugo是一个能把markdown转化成静态html网站的工具。
wordpress-to-hugo-exporter
说了这么多,言归正传,一键切换主要是使用这个插件:
wordpress-to-hugo-exporter
这个插件功能是通过提取wp的页面,将所有的可见页面转换成markdown文档。
生成md文件
支持两种方式:
1. 在wp插件页面通过按钮执行
2. 在后台命令行通过cli方式执行:
php hugo-export-cli.php
前者的文件会导出到用户客户端,后者生成的.zip在/tmp目录下。
后继的工作
这个插件只是将wp的内容转化成markdown文档,要创建hugo网站,你需要:
- 找一个你喜欢的theme,从hugo官网就能找到
- 根据theme的指导,配置相应的config文件,每一个theme的config会有略微差异
- 将之前的markdown打包文件根据你自己配置的目录层次解压到hugo的content目录下的对应路径中。
如果以上你都做对了,你应该已经可以看到你的hugo网站了。
相关参考:
一步一步教你用hugo搭建博客
中文支持的PR
拿到插件时,是不支持中文路径的,含有中文路径的文章,都是404。这个对大陆用户来说很不方便的,因为有很多人的文章都是有中文路径的。于是提交了对应的PR:
fix the unicode url issue and markdown format error
作者很勤快,很快就合入了主干,所以现在大家可以直接使用主干的代码,就是支持中文了。