WordPress 媒體庫盤點清單：搬站前先整理圖片、Alt 與封面來源
WordPress 舊站搬到 Next.js、Markdown 或靜態內容站時，最容易被低估的不是文章文字，而是媒體庫。圖片如果沒有盤點清楚，搬站後常會出現封面圖消失、Alt 文字遺失、文章內圖片仍指向舊網域，或社群分享卡片只剩一段文字的情況。
UCAMC 的舊文章很多來自 WordPress，後續也會持續整理封面圖、分類與 SEO metadata。這份清單可以放在每次搬站或舊文整理前，先把圖片資產變成可檢查、可回補、可長期維護的內容資料。
1. 先建立圖片來源清單
不要一開始就急著下載所有圖片。先把來源分成幾類，才知道風險在哪裡：
| 圖片來源 | 需要檢查的重點 |
|---|---|
| WordPress 媒體庫 | 原始檔名、尺寸、文章使用位置、Alt 文字。 |
| Cloudinary / CDN | 連結是否仍回 200、是否支援熱連、是否有轉檔參數。 |
| 外部圖床 | 授權、穩定性、是否可能失效。 |
| 文章內 HTML 圖片 | 是否還藏在舊 <img> 標籤或 shortcode 裡。 |
| 社群封面圖 | 是否有足夠比例與清晰度給 Open Graph / Twitter Card。 |
若搬站工具只轉出 Markdown 文字，圖片常會被留在原本 HTML 裡。這時候要先掃描 src="..."、Markdown  與 frontmatter 裡的 coverImage / featuredImage，不要只看文章頁表面是否能 build。
2. 每篇文章至少要有一張可用封面圖
對內容站來說，封面圖不只是裝飾，它會影響：
- Blog 列表卡片的可讀性。
- 文章頁第一眼的品牌完整度。
- Open Graph 與 Twitter Card 預覽。
- 舊文整理時的主題辨識。
- 未來做資源頁、電子報或社群貼文時的素材再利用。
在 UCAMC 目前的 Markdown frontmatter 裡，新文章應該補齊：
coverImage: 'https://example.com/image.jpg'
coverAlt: '用自然語言描述圖片內容與文章情境'
featuredImage: 'https://example.com/image.jpg'
coverAlt 不要只寫「圖片」或「banner」。比較好的寫法是描述畫面與用途，例如「筆電上的網站管理介面，象徵 WordPress 媒體庫與圖片 SEO 檢查」。這樣讀者、搜尋引擎與日後維護者都比較容易理解圖片角色。
3. 檢查圖片連結不是只看頁面有沒有 build
Next.js 內容站即使圖片 404，npm run build 仍可能成功。每日或搬站後應該另外檢查：
- 圖片 URL 回傳
200。 content-type是image/jpeg、image/png、image/webp等圖片格式。- 文章頁實際渲染時圖片沒有被破圖圖示取代。
- 手機版圖片不會超出容器寬度。
- 外部圖片授權與來源仍可接受。
如果圖片來自舊 WordPress 網域，建議記錄「是否要搬到 Cloudinary 或其他 CDN」。不要在未確認授權與檔案完整性前大量改寫連結。
4. Alt 文字與檔名要分開處理
媒體庫整理常見誤解是：檔名改好，Alt 就不用管。其實兩者用途不同：
- 檔名適合描述資產管理用途，例如
wordpress-media-audit-checklist-cover.jpg。 - Alt 文字要描述讀者看不到圖片時需要知道的資訊。
- Caption 則可補充來源、情境或教學說明。
舊文章若圖片只是裝飾，可以用簡短 Alt；若圖片承載教學步驟，就要把關鍵操作寫進正文或圖片旁的說明，不要只靠圖片本身。
5. 搬站前後的回補流程
可以把每篇文章的圖片整理成一個小表格：
| 欄位 | 範例 |
|---|---|
| 文章 slug | wordpress-media-library-audit-checklist |
| 原始圖片 URL | 舊 WordPress 或 CDN 連結 |
| 新封面圖 URL | Cloudinary / Unsplash / 自有 CDN |
| Alt 文字 | 描述圖片內容與文章用途 |
| 驗證狀態 | 200 image、文章頁可見、手機不溢位 |
| 待確認 | 授權、是否需重新裁切、是否需替換品牌圖 |
這張表不需要複雜工具，Google Sheet、Notion、Markdown 表格都可以。重點是讓「圖片可用性」變成可交接的內容維護項目，而不是搬站當天才靠肉眼檢查。
6. 與 UCAMC 內容維護流程串起來
整理媒體庫時，可以順手連到幾個既有維護節點：
- 若文章是 WordPress 舊站搬家，接著檢查 WordPress 內容搬家後的 SEO 盤點表。
- 若文章要補成日常維護流程，參考 WordPress 維護回滾紀錄模板。
- 若封面與卡片樣式不一致，搭配 前端 Design Token 巡檢模板。
- 若要確認 sitemap 與文章路由，使用 Next.js 內容站每日 SEO 巡檢清單。
媒體庫盤點的目標不是把舊站一次整理到完美，而是讓每次回補都有清楚欄位、驗證方式與下一步。當圖片、Alt、封面與 metadata 都能被持續維護，舊 WordPress 文章才會真正變成新的內容資產。