用 Create Block Theme 外掛匯出可重用主題

在站台編輯器裡調好顏色、字型、版面之後,那些改動其實只存在資料庫裡,換個佈景主題或搬到另一個站,全部歸零。Create Block Theme 外掛要解決的就是這件事,它把你在編輯器裡的設計抽出來、寫回主題檔案,再打包成一個可以重複安裝、可以送到別的網站、甚至可以上架到佈景主題目錄的 zip。這篇會帶你從安裝、設計、選對建立方式,一路走到匯出與重用,並說明哪些操作會永久改動網站、該怎麼先在測試環境驗過再上線。

Create Block Theme 外掛到底在做什麼

Create Block Theme 外掛是 WordPress 官方團隊維護的工具,作用是把站台編輯器(Site Editor)裡的設計,轉成標準的區塊佈景主題檔案並匯出。它的核心邏輯只有一句話:把存在資料庫裡的設計,寫回檔案系統。

在全站編輯(Full Site Editing)的架構下,你在編輯器調整的顏色、字型、版面、範本(template)與範本組件(template part),預設都是存在資料庫,不是寫進主題資料夾。這帶來一個現實問題:這些改動不會反映在主題的範本標記裡,一旦切換佈景主題就會遺失,也沒辦法直接搬到另一個網站。Create Block Theme 外掛把資料庫裡的這些變更撈出來,產生對應的 theme.json 與範本檔,補上這段「資料庫到檔案」的缺口。

要先講清楚它的適用範圍。這個外掛只支援區塊佈景主題,傳統佈景主題(Classic Theme)不適用,因為傳統主題沒有站台編輯器這套機制可以接。

安裝與啟用外掛的步驟

安裝方式和一般外掛一樣。登入 WordPress 控制台後,到「外掛」「安裝外掛」,搜尋欄輸入 Create Block Theme,找到後點「立即安裝」再「啟用」即可。這個外掛已經完成繁體中文在地化,介面選單會是中文,操作上省力不少。

啟用後有兩個入口,功能範圍不太一樣,值得先弄懂差別。第一個是控制台選單的「外觀」底下,會多出「建立區塊佈景主題」與「管理佈景主題字型」兩個項目,這個入口適合單純做匯出、複製這類動作。第二個入口在站台編輯器裡,打開編輯器後點右上角的板手(扳手)圖示,外掛的完整功能會在即時編輯環境裡展開,你可以邊改邊預覽邊存。

如果你要做的是比較完整的設計與儲存流程,建議走站台編輯器這個入口,控制台選單那邊的功能相對精簡。

先在站台編輯器把設計做好

匯出之前,所有設計都要先在站台編輯器完成。流程是先用全站樣式(Global Styles)介面或直接編輯 theme.json 來調整外觀,常見的改動包括首頁版面、新增頁面範本與頁尾組件、設定導覽選單、改顏色與字型。改完之後,這些變更會以「藍點」的形式標記在範本清單上,提醒你哪些範本被動過。

這裡有個容易混淆的地方要分清楚。站台編輯器右上角預設的「儲存」按鈕,存的是你在編輯器裡的設計變更,這些變更進的是資料庫。而外掛提供的「儲存變更」(Save Changes)按鈕,意義不同,它是把你想要匯出、寫進主題檔案的內容存下來。兩者不是同一件事,匯出前要先用預設的「儲存」把設計存好,外掛才抓得到這些變更。

外掛的儲存變更面板會列出幾個可以一併處理的選項,包括儲存字型、儲存範本變更、只處理修改過的範本、儲存同步的區塊樣式、文字在地化、圖片在地化、移除導覽參照等。這些選項決定了哪些東西會被一起寫進主題,依需求勾選即可。

六個建立選項分別在什麼情況下用

外掛提供六個與建立佈景主題有關的選項,分別是匯出目標佈景主題、建立子佈景主題、再製(複製)佈景主題、覆寫目標佈景主題、建立空白佈景主題、建立樣式變化。它們的差別不在操作難度,而在「會不會動到原主題」與「產出的是什麼」。先看清楚再選,可以省下不少回頭重做的時間。

下面這張表把六個選項的用途與影響整理在一起:

選項 產出 會不會改動原主題 適合情境
匯出目標佈景主題 含你變更的 zip 不會 想把目前主題搬到別站或備份
建立子佈景主題 一個新的子主題 不會,原主題保留可更新 只想小幅客製又要保留原主題更新
再製佈景主題 原主題的完整複本 不會,產生獨立新主題 想以現有主題為基礎做全新主題
覆寫目標佈景主題 把變更寫回現用主題 會,永久改動 確定要把客製固化進現用主題
建立空白佈景主題 極簡的起始主題 不會,產生新主題 想從乾淨底稿自己重頭設計
建立樣式變化 一組樣式變化 不會,可隨時切換 想保留多套配色與字型方案並切換

幾個實務上的判斷重點。如果你只是想做一點小客製、又想繼續吃原主題的更新,選子佈景主題;如果你想以某個主題當底、做成完全屬於自己的新主題,選再製;如果你確定要把資料庫裡的客製永久固化進目前這個主題,才選覆寫,這個動作之後不能從站台編輯器還原。

把設計匯出成可重用的 zip 主題

匯出是這個外掛最常被用到的功能,目的是把目前啟用、含你所有變更的主題打包成一個標準的佈景主題 zip。操作很直接:到「外觀」「建立區塊佈景主題」,選匯出選項,按產生按鈕,檔案就會像一般佈景主題那樣下載到你的下載資料夾,是個 zip 檔。

拿到 zip 之後怎麼用在另一個網站?到目標站的「外觀」「佈景主題」,點「新增」再「上傳佈景主題」,把 zip 傳上去安裝啟用即可,流程跟安裝任何外部主題一樣。匯出的內容會完整保留你做過的範本、全站樣式、字型與其他結構性變更。

有人會問,這跟站台編輯器內建的匯出功能差在哪?答案是產出幾乎一樣。站台編輯器本身就有匯出主題的功能,藏在編輯器右上角三點選單的工具區,匯出的檔案結構與外掛匯出的結果實測相同。外掛的價值在於它把匯出、複製、子佈景、樣式變化這些動作集中在一個介面,操作上更順,而不是匯出結果有本質差異。

字型管理與中文字型的取捨

字型管理是外掛另一個重要功能,也是區塊內容編輯時最常需要的一塊。它讓你透過 WordPress 字型庫(Font Library)安裝並啟用任何來源的字型,再用「儲存字型」把目前啟用的字型全部寫進現用主題。一旦字型存進主題,它就會在主題裡啟用、從系統層停用,系統層那份可以安全刪掉。

中文字型可以從 Google Fonts 挑,例如思源黑體系列的 Noto Sans TC 就很常用,可以一次選好幾種粗細規格。挑好之後回到文章編輯畫面,在區塊的排版樣式裡找到「字型系列」,剛才新增的字型就會出現在選單裡可以套用。

中文字型有個一般英文字型不太需要擔心的問題要特別提醒:檔案大小。中文一套字型動輒涵蓋上萬個字符,檔案比拉丁字型大上許多,把多種粗細全部塞進主題會讓主題體積膨脹,影響網站載入效率。實務上建議只保留版面真正會用到的粗細,不要一次把細體到黑體七八種全收進來。

theme.json 與資料庫到檔案的運作原理

理解外掛背後做了什麼,能幫你判斷匯出結果對不對。匯出工具會先把現用主題的所有檔案複製進一個 zip,接著檢查資料庫裡範本與 theme.json 的變更,把這些變更抽出來,覆蓋掉同名的檔案。換句話說,最終的 zip 是「原主題檔案」加上「資料庫裡的客製」合併後的成果。

過程中有兩個細節值得知道。第一,基於安全考量,範本檔裡的部分內容會被淨化(sanitize),例如 CSS 變數會被轉成 Unicode 跳脫的寫法,這是正常行為,不是壞檔。第二,theme.json 的屬性會被依字母順序重新排列,結構描述(schema)也可能更新成符合你站台目前 WordPress 版本的格式。

外掛還提供唯讀檢視 theme.json 的功能,匯出前可以先看一眼,確認你調的顏色、字型、版面設定都正確進到檔案裡。對子佈景主題來說,這個檢視只會顯示不影響母主題的客製內容,母主題本身維持原狀。如果結果不如預期,外掛也有重置功能,可以把樣式、範本、範本組件回退到上一次儲存的狀態;想要更細緻的版本控制,WordPress 內建的修訂版本(Revisions)功能會記錄完整變更歷史,能更精準地還原。

為什麼正式環境上線前一定要先測試

這個外掛官方文件用了一個很貼切的比喻:可以把它想成 WordPress 的「開發模式」。它的部分操作會永久改動你的網站或主題,最典型的就是覆寫選項,一旦把資料庫客製寫回現用主題,就無法再從站台編輯器復原,只能手動改回程式碼或重做一次客製。

正因如此,強烈建議在測試(staging)環境操作,確認結果無誤再套用到正式站。很多代管服務都提供一鍵建立測試環境的功能,先在那邊把匯出、覆寫、樣式變化整套流程跑過一遍,看前台呈現是否正確,再決定要不要動正式站。這個外掛仍在積極開發中,會持續新增功能,但也意味著可能出現破壞性變更,測試環境先行是最低限度的自保。

另外要留意,操作過程中外掛會跳出瀏覽器提示,告訴你接下來這一步要做什麼。不要無腦按過去,那些提示往往就是在警告你這個動作不可逆。

把匯出的主題分享或上架到佈景主題目錄

如果你想把做好的主題分享出去,甚至上架到 WordPress 官方佈景主題目錄,匯出的 zip 還需要補幾項東西才算完整。要更新的項目包括:替主題加上代表性的螢幕截圖(screenshot)、補上 readme.txt 的更新紀錄、在 style.css 裡填正確的版本號、把所有相關檔案裡的主題名稱統一更新、確認授權檔案有附上。全部處理好之後重新打包成 zip,再依官方的佈景主題提交流程送出。

正式提交前,建議再對照一次官方佈景主題手冊(Theme Handbook)的最新規範,提交準則會隨版本調整。即使你沒有要上架、只是內部重用,把主題名稱、作者、版本這些中介資料(metadata)填清楚也是好習慣,外掛本身就提供編輯主題中介資料的介面,主題名稱、描述、作者、版本、相容的最低 WordPress 版本、標籤、相依外掛、字型與圖片來源致謝都可以在裡面改。

從設計到可重用主題,該照什麼順序走

把這套流程收束成一條可以照做的路徑:先在站台編輯器把顏色、字型、版面、範本都調好並用預設「儲存」存進資料庫,再依需求選對建立方式,最後匯出成 zip。決策的關鍵只有一個問題,你要不要保留原主題。要保留原主題又想小改,走子佈景;想以它為底做全新主題,走再製或空白;想固化進現用主題,才用覆寫,而且要先在測試環境驗過。

設計不該只活在資料庫裡,承擔著換主題就消失的風險。把它寫回檔案、打包成 zip,這份設計才真正屬於你,能搬站、能備份、能重複套用。下一步很簡單:先在測試環境裝好 Create Block Theme 外掛,拿一個現有的區塊主題試著匯出一次,把整段流程走過,你就會清楚自己的網站該選哪一種建立方式。

相關文章
標籤: 全站編輯, 站台編輯器, 區塊佈景主題, Create Block Theme, theme.json