From d5d8a8370595cf22e9ffabb6e0e72057058b63e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aur=C3=A9lien=20PIERRE?= Date: Tue, 17 Sep 2024 14:09:52 +0200 Subject: [PATCH 1/2] Re-organize supported features in README in sections --- README.md | 62 ++++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 43 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 27b777c..5f56457 100644 --- a/README.md +++ b/README.md @@ -62,37 +62,61 @@ $ make build_prod ## Goals of `wp2hugo` +### Migrate post types, taxonomies and their archive pages + 1. [x] Migrate posts 1. [x] Migrate pages 1. [x] Migrate tags 1. [x] Migrate categories -1. [x] Migrate all the URLs including media URLs correctly -1. [x] Generate Ngninx config containing GUID -> relative URL mapping -1. [x] Migrate iframe(s) like YouTube embeds -1. [x] Migrate "Excerpt" -1. [x] Migrate "catlist" +1. [x] Migrate [Avada](https://themeforest.net/item/avada-responsive-multipurpose-theme/2833226) custom post types (FAQ, Portfolios) 1. [x] Set the WordPress homepage correctly +1. [x] Create WordPress author page + +### Migrate permalinks + +1. [x] Migrate all the URLs including media URLs correctly +1. [x] Generate Nginx config containing GUID -> relative URL mapping 1. [x] Migrate the RSS feed with existing UUIDs, so that entries appear the same - this is important for anyone with a significant feed following, see more details of a [failed migration](https://theorangeone.net/posts/rss-guids/) -1. [x] Migrate favicon.ico -1. [x] Migrate [YouTube embeds](https://support.google.com/youtube/answer/171780), including WordPress-style plain-text URLs [pasted](https://wordpress.org/documentation/article/youtube-embed/) into the content -1. [x] Migrate [Google Map embed](https://developers.google.com/maps/documentation/embed/get-started) via a custom shortcode `googlemaps` -1. [x] Migrate [GitHub gists](https://gist.github.com/) -1. [x] Migrate `caption` (WordPress) to `figure` (Hugo) +1. [x] Map WordPress's RSS `feed.xml` to Hugo's RSS `feed.xml` + +### Migrate post content and shortcodes + +1. [x] Migrate "Excerpt" 1. [x] Migrate "Show more..." of WordPress -> `Summary` in Hugo -1. [x] Support for parallax blur (similar to [WordPress Advanced Backgrounds](https://wordpress.org/plugins/advanced-backgrounds/)) +1. [x] Migrate "catlist" 1. [x] Migrate WordPress table of content -> Hugo -1. [x] Custom font - defaults to Lexend -1. [x] Use draft date as a fallback date for draft posts -1. [x] Maintain the draft status for draft and pending posts 1. [x] Migrate code blocks correctly - migrate existing code class information if available -1. [x] Download embedded photos while maintaining relative URLs -1. [x] Map WordPress's `feed.xml` to Hugo's `feed.xml` -1. [x] WordPress [footnotes](https://github.com/ashishb/wp2hugo/issues/24) -1. [x] WordPress page author -1. [x] Ability to filter by author(s), useful for [WordPress multi-site](https://www.smashingmagazine.com/2020/01/complete-guide-wordpress-multisite/) migrations +1. Migrate embeds: + 1. [x] Migrate iframe(s) like YouTube embeds + 1. [x] Migrate [YouTube embeds](https://support.google.com/youtube/answer/171780), including WordPress-style plain-text URLs [pasted](https://wordpress.org/documentation/article/youtube-embed/) into the content + 1. [x] Migrate [Google Map embed](https://developers.google.com/maps/documentation/embed/get-started) via a custom shortcode `googlemaps` + 1. [x] Migrate [GitHub gists](https://gist.github.com/) +1. Migrate WordPress shortcodes: + 1. [x] Migrate `[caption]` shortcode (WordPress) to `{{< figure >}}` (Hugo) ([reference](https://codex.wordpress.org/Caption_Shortcode)) + 1. [x] Migrate `[audio]` shortcode ([reference](https://wordpress.org/documentation/article/audio-shortcode/)) +1. Migrate Gutenberg blocks and features: + 1. [x] WordPress [footnotes](https://github.com/ashishb/wp2hugo/issues/24) + +### Migrate post metadata and attributes + +1. [x] Maintain the draft status for draft and pending posts +1. [x] Use draft date as a fallback date for draft posts 1. [x] Featured images - export featured image associations with pages and posts correctly 1. [x] WordPress [Post formats](https://developer.wordpress.org/advanced-administration/wordpress/post-formats/) +### Migrate media attachments + +1. [x] Migrate favicon.ico +1. [x] Migrate `wp-content/uploads` images embedded in pages to Hugo static files while maintaining relative URLs +1. [x] Migrate external images (on different hosts) to Hugo static files + +### Misc + +1. [x] Ability to filter posts by author(s), useful for [WordPress multi-site](https://www.smashingmagazine.com/2020/01/complete-guide-wordpress-multisite/) migrations +1. [x] Custom font - defaults to Lexend +1. [x] Support for parallax blur backgrounds (similar to [WordPress Advanced Backgrounds](https://wordpress.org/plugins/advanced-backgrounds/)) + + ### Why existing tools don't work [Existing tools](https://gohugo.io/tools/migrations/) do a half-baked job of migrating content. From 997c2479ac297c4cc397c63792230eae07080249 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Aur=C3=A9lien=20PIERRE?= Date: Tue, 17 Sep 2024 14:43:20 +0200 Subject: [PATCH 2/2] fix MD linting --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 5f56457..0899d87 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,6 @@ $ make build_prod 1. [x] Custom font - defaults to Lexend 1. [x] Support for parallax blur backgrounds (similar to [WordPress Advanced Backgrounds](https://wordpress.org/plugins/advanced-backgrounds/)) - ### Why existing tools don't work [Existing tools](https://gohugo.io/tools/migrations/) do a half-baked job of migrating content.