wp2hugo：WordPress 到 Hugo 的迁移利器，301 Star

文章目录wp2hugoWordPress 到 Hugo 的迁移利器301 Starwp2hugoWordPress 到 Hugo 的迁移利器301 Starwp2hugo 是一个用 Go 编写的 WordPress 到 Hugo 静态站迁移工具。作者 ashishb 在迁移个人博客时遇到了各种边角情况于是写了这个工具。目前项目在 GitHub 上获得了 301 个 Star。什么是 wp2hugowp2hugo 把 WordPress 的 XML 导出文件转换成 Hugo 站点的 Markdown 文件。虽然是针对 Hugo 设计的但生成的 Markdown 文件也可以在 Mkdocs、Jekyll 等其他静态站点生成器上使用。它编译成单个可执行文件不需要安装任何依赖就能运行。相比那些跑在服务器上的 PHP 迁移插件wp2hugo 在性能上有明显优势。大博客几分钟就能处理完而 WordPress 插件可能会超时、内存溢出甚至全面失败。能迁移什么这个工具覆盖了迁移过程中可能遇到的方方面面文章和页面支持层级页面结构使用 Hugo 的 page bundles分类系统标签、分类法、自定义分类法全部保留评论旧评论自动迁移需要手动在 Hugo 主题中插入代码片段URL 和永久链接所有链接包括媒体链接都做正确映射还能生成 Nginx 重定向配置RSS 源保留原有的 UUID订阅者不会看到重复条目草稿状态草稿和待审核文章保留其发布状态短代码和内容处理WordPress 的特色之一是一大堆短代码和 Gutenberg 块。wp2hugo 对这部分做了针对性处理WordPress 原生的 caption、audio、gallery 短代码都转成 Hugo 对应的格式表格目录块、代码块保留语言分类信息、文章摘要、more 分隔符YouTube 嵌入包括纯文本版和 WP YouTube Lyte 插件版Google 地图嵌入、GitHub gist 嵌入iframe 嵌入Gutenberg 块中的脚注、YouTube、图片和画廊媒体文件处理下载嵌入文章中的图片保持相对路径处理外部域名上的图片可选导入 WordPress 媒体库中的所有附件自定义附件标题导入到/data/library.yaml安装和使用有两种方式获取 wp2hugo。下载编译好的二进制文件是最快的方式从 GitHub Releases 页面下载对应系统的版本即可。如果需要从源码构建git clone gitgithub.com:ashishb/wp2hugo.git cd wp2hugo/src/wp2hugo make build_prod ./bin/wp2hugo --source wordpress-export.xml --download-media使用方式也很直接从 WordPress 后台导出 XML 文件然后运行一行命令wp2hugo --source wordpress-export.xml --download-mediawp2hugo 附带了一个叫 hugomanager 的实验性工具功能包括 URL 自动生成、站点状态概览、图片压缩、backlink 分析等。实际案例项目 README 中列出了 20 多个成功迁移的站点包括个人博客、技术站、中文和西班牙语博客。商业使用项目对个人和非商业用途完全免费。商业使用需要单独授权。总的来看wp2hugo 是一个针对性很强的工具解决的是 WordPress 老用户迁移到 Hugo 过程中那些琐碎而头疼的问题。如果你正在考虑从 WordPress 搬家到 Hugo这个工具值得一试。是 WordPress 老用户迁移到 Hugo 过程中那些琐碎而头疼的问题。如果你正在考虑从 WordPress 搬家到 Hugo这个工具值得一试。