WordPress 遷移至 EmDash 指南
以分階段匯入流程、媒體驗證與自訂內容規劃，將 WordPress 網站搬進 EmDash。
從 WordPress 遷到 EmDash，最輕鬆的做法是先把它當成「內容與 schema 專案」，而不是「重做主題」的練習。先把內容搬過去、驗證媒體與結構，等資料模型穩定後再處理自訂呈現與設計對等。
開始之前
在執行任何匯入前，先確認你要搬的是哪一種 WordPress 網站。
請先檢視：
- 標準文章與頁面
- 媒體附件
- 自訂文章類型
- 自訂欄位與編輯後設資料
- Gutenberg 區塊或大量短碼的內容
這很重要：單純發佈型網站通常能乾淨匯入；若高度依賴自訂區塊、外掛產生的欄位或特殊前台呈現，匯入後多半還需要第二輪實作。
匯入選項
將 WordPress 內容帶進 EmDash，有兩種合理方式。
WXR 匯出
若你希望以檔案為主的遷移流程，請使用 WXR 匯出。
通常在下列情況較適合：
- 需要可攜的匯出產物
- 多人需要審閱或封存來源匯出
- 希望在來源資料與目的地驗證之間有清楚界線
典型流程：
- 開啟 WordPress 後台。
- 將網站內容匯出為
WXR檔。 - 在 EmDash 以該匯出檔開始匯入。
- 檢視匯入的條目與媒體。
EmDash Exporter 外掛
若你希望從線上 WordPress 直接轉移，請使用 EmDash Exporter 外掛。
典型流程：
- 在 WordPress 網站安裝此外掛。
- 設定它提供的安全匯出端點。
- 以 WordPress Application Password 保護存取。
- 從該受保護來源對 EmDash 執行匯入。
當來源站仍在積極維運、且你希望直接拉取而非傳遞匯出檔時，此方式較佳。
建議路徑
多數團隊最安全的順序是：
- 準備好要接收內容的 EmDash 網站。
- 選定一種匯入方式並執行第一輪遷移。
- 確認條目與媒體是否正確到達。
- 為不應維持通用編輯內容的項目，建立適當的 EmDash 內容類型。
- 僅在匯入內容結構可信後，才重建自訂呈現。
這樣可以把最高風險的工作留到資料已在 EmDash 可見、可審閱之後。
匯入後驗證
不要以「匯入是否完成」評判遷移，而要以「匯入內容是否可用」評判。
第一輪驗證應檢查：
- 文章與頁面數量是否符合預期
- 附件媒體是否已進入 EmDash 媒體庫
- 標題、內文與發佈相關後設資料是否合理
- 編輯上的關聯在匯入後是否仍合理
此階段請克制先修視覺細節的衝動。若內容模型仍不對，設計工作很容易變成昂貴的重做。
自訂內容
WordPress 網站常會超出預設 Post 與 Page 模型。若使用自訂文章類型，遷移時應視為 schema 決策，而非單純格式問題。
在 EmDash 中，較好的做法是為值得獨立結構的內容建立原生內容類型。通常需要檢視：
- 哪些內容應維持標準編輯條目
- 哪些應成為獨立的 EmDash 集合（collections）
- 哪些欄位應明確建模，而非隱含在內文裡
遷移品質往往在這裡成敗。技術上匯入可能成功，但若每種內容形狀都被壓成通用條目，EmDash 實作品質仍會偏弱。
區塊與客製呈現
自訂區塊應刻意處理。若舊站依賴客製 Gutenberg 區塊、短碼驅動版型或外掛專屬呈現，請預期後續工作。
合理做法是：
- 先匯入底層內容
- 辨識遷移後仍需保留的呈現模式
- 以 EmDash 原生工具與元件重建這些部分
若需重建客製區塊行為，可從 EmDash Block Kit Agent Skill 開始。
實務檢查清單
可作為遷移工作清單：
- 在 WordPress 稽核文章、頁面、媒體與自訂文章類型
- 決定
WXR與 EmDash Exporter 外掛何者較適合 - 準備目的地 EmDash 網站
- 執行第一輪匯入
- 驗證媒體傳輸與條目完整性
- 在需要處建立原生 EmDash 內容類型
- 標出需要第二輪實作的自訂呈現
- 在嘗試視覺對等前，先審閱內容結構
仍須規劃的部分
即使有乾淨的匯入路徑，部分遷移工作仍在匯入器之外：
- 重新導向（redirects）
- SEO 對等檢查
- 欄位整理
- 自訂呈現對等
- 回滾與上線時序
匯入把內容帶進 EmDash，並不能取代編輯審閱、schema 決策與上線紀律。