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