html2wp / 部落格 / Claude Design 轉 WordPress
Claude Design 轉 WordPress:如何把設計轉換成佈景主題
在所有生成式設計中,從 Claude Design 轉到 WordPress 是最短的轉換路線。如果 Claude 以 HTML 形式給了你設計,那它正是轉換器想要的輸入:不用建置,不用額外的瀏覽器步驟,也沒有框架。唯一要檢查的是,一個 artifact 是否足夠撐起你的網站。轉換仍在你自己的電腦上執行,所以需要 Docker、Node 和 Python。清單見下文,很短。
轉到 WordPress 之前:Claude Design 給了你什麼輸出?
Claude 會產生兩種輸出,每種走不同的路線。開始之前先確認你手上是哪一種,因為它決定了轉換需要多長時間。
| Claude 給了你什麼 | 它是什麼 | 路線 |
|---|---|---|
一個獨立完整的 .html 檔案:程式碼、樣式和指令碼都在裡面。 |
就是本文。它已經是靜態 HTML,正是轉換器需要的輸入。 | |
| 一個元件。頁面只有在 JavaScript 執行後才會出現,外層的 HTML 只是一個供 App 掛載的空元素。 | Lovable 逐步指南:同類輸入,同樣多出一步。 |
如果不確定,開啟檔案,看看 <body> 裡面。如果能看到你的標題和段落,那就是 HTML artifact,你來對地方了。如果 body 裡只有一個空的 <div> 和一個 script 標籤,那就是另一種。
為什麼 HTML 更簡單
React 專案必須先建置,再在真實瀏覽器中開啟,才有可轉換的內容。HTML artifact 省掉了這一步。程式碼已經完整寫在檔案裡,後面的每一步都從中讀取。
從 Claude Design 匯出到資料夾,包括圖片
輸入始終是你磁碟上的一個資料夾。線上網址不是受支援的輸入,這是有意為之。已發布頁面的副本只保留渲染結果,會丟失原始檔所掌握的資訊。
所以,從 Claude 匯出設計(下載 artifact),新增一個資料夾,把檔案以 index.html 的名稱儲存進去。如果設計連結了不在檔案內部的圖片,把它們放在旁邊,放在程式碼所期望的相對位置。
mkdir my-site && cd my-site
mv ~/Downloads/artifact.html index.html
mkdir -p images # if the design uses any images
一個頁面,還是多個?
一個 artifact 就是一個頁面,單頁網站可以順利轉換,它會成為佈景主題的首頁。如果你想要帶「關於」和「聯絡」頁面的網站,也請 Claude 產生這些頁面,並把每個頁面分別儲存為同一資料夾中的 .html 檔案。檔名很重要:分析步驟會讀取檔名,並根據名稱理解 blog.html 或 about.html 這樣的檔案。
如果不超過 5 個檔案,整個轉換都在免費版範圍內。
Claude Design 轉 WordPress 對電腦的要求
較短的路線同樣在你的電腦上執行,要求並不會減少。瀏覽器和臨時 WordPress 是用來檢查結果的,而不是用來產生結果的:
- Node 20 或更高版本,以及安裝了 Playwright 和 Pillow 套件的 Python 3。
- Docker,並帶有
docker compose指令。它在你的電腦上啟動一個臨時 WordPress,轉換器先把佈景主題安裝到那裡,然後才交給你。 - php-cli,因為每個 PHP 檔案在放進 ZIP 之前都要經過語法檢查。
jq、curl、bash和tar。目標 WordPress 必須是 6.6 或更高版本。
第一步會檢查所有這些。它會區分哪些可以在你自己的資料夾裡自行安裝,哪些需要你來決定。除非你要求,否則它不會替你安裝 Docker。
Docker 不是可選項,也最讓人意外
在瀏覽器裡執行的轉換器不需要它,因為它跳過了這一步。這裡,產生的佈景主題會放進一個真實的 WordPress,轉換器先在那裡測試,然後才交給你。容器正是為此而用。如果 Docker 沒有執行,轉換會在第一步就停下並立即告訴你,而不是等到最後。
執行 Claude Design 到 WordPress 的轉換
Claude Code
/plugin marketplace add iOSDevSK/html2wp-cc-plugin /plugin install html2wp@html2wp
python3 -m playwright install chromium
Codex
codex plugin marketplace add iOSDevSK/html2wp-codex-plugin codex plugin add html2wp@html2wp
然後,在任意位置輸入:
/html2wp:html2wp
convert ./my-site
資料夾路徑就是全部指令。你不用寫設定檔,也不用選擇建置指令。在 Codex 中,輸入 convert ./my-site with html2wp。如果你不想用終端機,可以在 html2wp 桌面應用程式中開啟同一個資料夾(這是一篇帶截圖的指南)。
Flash 大約需要 30 分鐘,Full 大約一小時,具體取決於頁面數量和電腦速度。單頁 artifact 耗時較短,但無論輸入多小,檢查都會完整執行。
它替你決定什麼,又會問你什麼
在產生任何東西之前,它會先測量你的檔案。它列出頁面,判斷程式碼中哪些部分是共用的、哪些是獨有的。它還會找出設計變數(design tokens)、任何像部落格的內容,以及哪些頁面是獨立的。然後,它寫下計畫,並按計畫進行轉換。
生成式設計經常遇到兩種情況:
- 每個設計變體都會保留。如果你的頁面不共用同一個頁首,它不會挑出一個然後把其餘的抹平。它會為每個變體建立一個範本組件,並把每個頁面連線到它實際使用的那個。來自不同 Claude 對話的 artifact,差異往往比你記得的更大。
- 文字中的花括號會保留下來。中間步驟使用類似 JSX 的格式。如果不處理,你文字中的 JSON 或 CSS 範例會破壞建置,或在頁面上顯示為
{。轉換器會處理它們,所以花括號在頁面上仍然是花括號。
重複的內容組,例如卡片、客戶評價或常見問題,會儲存為集合,而不是寫死的標記。因此,之後你真的可以編輯它們,而不只是看起來能編輯。
不能跳過的檢查
轉換器會把每個頁面和它的原版並排放進一張圖裡,你要從上到下逐一看完每一張。
有一次轉換中,頁面靠下的位置缺了一個區塊,而像素比對只顯示 0.4% 的差異,於是通過了檢查。數值檢查天生看不到三類缺陷。第一類是看起來完美、卻什麼都不做的控制項。第二類是從範本來源的那一個頁面寫死進來的值。第三類是只有在捲動、點選或提交表單後才會出現的問題。
還要檢查內容能不能編輯。一個頁面可以做到像素級一致,卻沒有人能在 wp-admin 中編輯它的常見問題或功能網格。這種情況確實發生過,發現它的是這次人工檢查,而不是任何自動檢查。
轉成 WordPress 後如何編輯:佈景主題、Visual Edit 還是頁面編輯器
你的資料夾裡會多出兩個檔案:佈景主題 ZIP,以及旁邊的 CONVERSION-REPORT.md。報告列出轉換涵蓋了什麼、檢查發現了什麼、還有哪些未解決。佈景主題的安裝方式和任何 WordPress 佈景主題一樣(外觀 → 佈景主題 → 安裝佈景主題 → 上傳佈景主題)。
佈景主題是獨立的。頁面、部落格、表單、選單、SEO 和重新導向都是它自己的程式碼。它不需要外掛就能執行,也從不連線我們的伺服器。部落格文章在區塊編輯器裡寫,頁面文字仍保留在 HTML 中。想不寫程式碼就編輯頁面,有兩個選擇:Visual Edit 和頁面編輯器。
| 方式 | 你得到什麼 | 你付出什麼 |
|---|---|---|
| 只用佈景主題 | 你的程式碼,原封不動,上面不裝任何東西。沒有需要續訂的東西,也不會因為別人的更新而出問題。 | 沒有外掛時,頁面文字要在 HTML 裡修改。如果客戶想自己改,可以用 Visual Edit(Lite 免費)。 |
| Visual Edit,我們的外掛 | 在頁面上點選標題,輸入新內容,然後儲存。文字、圖片、連結、表單和選單都在原處編輯,程式碼保持不變。Lite 免費,不需要授權金鑰。 | 多裝一個外掛。Lite 保留 10 步歷史紀錄,沒有 AI 聊天。Pro 兩者都有,每年 €59。 |
| Elementor 或其他頁面編輯器 |
對已經在用它的人來說是熟悉的工作環境,客戶也能不靠你自己重做頁面。 | 程式碼被重建為編輯器小工具。它不再是 Claude 做的那個設計。之後,網站離開 Elementor 就無法顯示,你還要繼承它的結構、CSS 和更新。 |
當設計只是一個起點時,頁面編輯器是不錯的選擇。當設計本身就是你要交付的東西時,它就是糟糕的選擇。如果你轉換的目的是讓產生的設計在 WordPress 中保留下來,把它重建成小工具就違背了初衷。但如果下個季度會有別人重做版面,那麼他們對 Elementor 的熟悉,可能比忠實還原設計更有價值。
如果選擇 Visual Edit:Lite 還是 Pro
| Lite(免費) | Pro | |
|---|---|---|
| 點選即編輯內容 | ✓ | ✓ |
| 表單、選單、SEO 欄位 | ✓ | ✓ |
| 透過 AI 聊天編輯 | – | ✓,使用你自己的 API 金鑰 |
| 佈景主題匯出 | – | ✓ |
| Turnstile 表單保護 | – | ✓ |
| AI 圖片編輯和圖片產生動畫 | – | ✓ |
| 編輯歷史 | 10 步 | 300 步 |
AI 聊天使用你自己的 API 金鑰。我們不向你出售 token,費用由你與服務商結算。
Claude Design 轉 WordPress 的價格和拒絕的情況
對所有人免費,無需金鑰,無需註冊:3 次轉換,每次 5 個頁面,另有共 5 次重新執行。兩項次數都按 IP 位址計算,所以只有一個 IP 的辦公室只有一份額度。免費版用於試用工具、個人網站和非商業用途。
Pro 授權取消頁數限制,轉換和重新執行都不限次數。它還解鎖把商店轉換為 WooCommerce 的步驟。這一步從不免費:對於帶商店的網站,App 會直接拒絕免費轉換,而不是只做一半。你可以在價格頁面按月或按年購買 Pro,測試期間首次付款享 30% 折扣。
有一點要注意:這是測試版。檢查能發現大部分差異,但不是全部。因此,把每個頁面和原版對照檢視是流程的一部分,而不是可有可無的潤色。也因此,你應該先免費轉換一個自己的專案,然後再決定是否信任它。
整個流程的逐步指南見 html2wp App 文件。如果你的 artifact 是 React,Lovable 轉 WordPress 指南介紹了那條路線。