wp2hugo

WordPress 到 Hugo 静态站点迁移器

这是将 WordPress 导出迁移到 Hugo 的最佳迁移器。它处理了我在尝试将我的个人网站迁移到基于 Hugo 的网站时遇到的几个奇怪的边缘情况。

虽然这主要针对基于 Hugo 的代码生成，但可以使用它将 WordPress 博客转换为基于 Markdown 的文件，这些文件可以与其他系统（例如 Mkdocs 或 Jekyll）一起使用。

商业用途

我希望这个项目能够尽可能广泛地开放，同时仍然为开发成本提供资金。该项目完全免费，可供非商业和个人使用。商业用途通过许可证受到限制。如果您想获得商业许可，请随时与我联系。

用法

二进制

• 从发行版下载wp2hugo工具
• 通过管理仪表板中的Tools -> Export导出您的 WordPress 网站
• 假设下载的文件是wordpress-export.xml使用$ wp2hugo --source wordpress-export.xml --download-media生成网站

$ wp2hugo
Usage of wp2hugo:
 -authors string
   CSV list of author name(s), if provided, only posts by these authors will be processed
  -color-log-output
   enable colored log output, set false to structured JSON log (default true)
  -continue-on-media-download-error
   continue processing even if one or more media downloads fail
  -download-media
   download media files embedded in the WordPress content
  -font string
   custom font for the output website (default " Lexend " )
  -media-cache-dir string
   dir path to cache the downloaded media files (default " /tmp/wp2hugo-cache " )
  -output string
   dir path to write the Hugo-generated data to (default " /tmp " )
  -source string
   file path to the source WordPress XML file

从源代码构建

$ git clone [email protected]:ashishb/wp2hugo.git
$ cd wp2hugo/src/wp2hugo
$ make build_prod
# `./bin/wp2hugo` will contain the binary and you can use it as `$ ./bin/wp2hugo --source wordpress-export.xml --download-media`

通过包管理器安装

wp2hugo的目标

迁移帖子类型、分类法及其存档页面

1. 迁移帖子
2. 迁移页面
3. 迁移标签
4. 迁移类别
5. 迁移 Avada 自定义帖子类型（常见问题解答、作品集）
6. 正确设置WordPress主页
7. 创建 WordPress 作者页面

迁移永久链接

1. 正确迁移包括媒体 URL 在内的所有 URL
2. 生成包含 GUID -> 相对 URL 映射的 Nginx 配置
3. 使用现有 UUID 迁移 RSS 提要，以便条目显示相同 - 这对于拥有大量提要关注者的任何人都很重要，请参阅失败迁移的更多详细信息
4. 将 WordPress 的 RSS feed.xml映射到 Hugo 的 RSS feed.xml

迁移帖子内容和短代码

1. 迁移页面摘录
2. 迁移 WordPress 的“显示更多...” -> Hugo 中的Summary
3. 迁移列表类别帖子(catlist)
4. 迁移 WordPress 目录 -> Hugo
5. 正确迁移代码块 - 迁移现有的代码类信息（如果有）
6. 迁移嵌入：
   1. 像 YouTube 嵌入一样迁移 iframe
   2. 迁移 YouTube 嵌入内容
   3. 迁移帖子正文中嵌入的 WordPress 风格纯文本 YouTube
   4. 迁移 WP YouTube Lyte YouTube 嵌入
   5. 通过自定义短代码googlemaps迁移 Google 地图嵌入
   6. 迁移 GitHub gists
7. 迁移 WordPress 短代码：
   1. 将 WordPress [caption] 短代码迁移到 Hugo 的 {{<figure>}})
   2. 迁移 WordPress [音频] 短代码）
8. 迁移古腾堡块和功能：
   1. 迁移 WordPress 脚注
   2. 迁移 WordPress 画廊（包括空画廊）

迁移帖子元数据和属性

1. 维护草稿和待定职位的草稿状态
2. 使用草稿日期作为草稿帖子的后备日期
3. 特色图像 - 正确导出与页面和帖子关联的特色图像
4. WordPress 帖子格式

迁移媒体附件

1. 迁移 favicon.ico
2. 将页面中嵌入的wp-content/uploads图像迁移到 Hugo 静态文件，同时维护相对 URL
3. 将外部镜像（不同主机上）迁移到Hugo静态文件

杂项

1. 能够按作者过滤帖子，对于 WordPress 多站点迁移很有用
2. 自定义字体 - 默认为 Lexend
3. 支持视差模糊背景（类似于 WordPress 高级背景）

为什么现有工具不起作用

现有工具在迁移内容方面做得并不成熟。他们很少正确迁移 GUID、YouTube 嵌入、Google 地图嵌入和代码嵌入等元数据。

雨果经理

该存储库包含一个实验工具hugomanager 。我使用此工具根据标题自动生成 URL，并了解哪些博客文章仍标记为草稿或哪些博客文章计划很快发布。

你可以通过构建它

src/wp2hugo $ make build_hugo_manager
...

src/wp2hugo $ ./bin/hugomanager
A tool for managing Hugo sites e.g. adding URL suggestions, generating site status summary etc.

Usage:
  hugomanager [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  help        Help about any command
  sitesummary Print site stats (e.g. number of posts, number of drafts etc.)
  urlsuggest  Suggests URLs for all the pending/future posts that are missing a URL
  version     Print the version number of HugoManager

Flags:
  -a, --author string    author name for copyright attribution (default " YOUR NAME " )
      --config string    config file (default is $HOME /.cobra.yaml)
  -h, --help             help for hugomanager
  -l, --license string   name of license for the project
      --viper            use Viper for configuration (default true)

Use " hugomanager [command] --help " for more information about a command.

笔记：

1. 要迁移评论，请使用 Remark42