長文章拉到一半找不到段落,讀者通常直接關掉。一份排在文章開頭的目錄,能讓人先掃過全文架構,再點進想看的章節,這正是 WordPress 文章目錄外掛要解決的事。但市面上的目錄外掛不只一款,光是中文圈最常被提到的 Easy Table of Contents 與 LuckyWP Table of Contents,兩者的安裝方式、自訂彈性與適用情境就有明顯差別。這篇會帶你把兩款外掛各自裝起來、設定到能正常運作,再用一張對照表理清該選哪一款,最後處理目錄不顯示、錨點跳錯位這類實際會卡住的狀況。
文章目錄外掛到底在做什麼
文章目錄外掛的工作,是自動抓取一篇文章裡的標題標籤(H2、H3、H4 這類),替每個標題產生錨點連結,再把它們整理成一份可點擊的清單,通常放在內文開頭。讀者點目錄上的任一項,頁面就會捲動到對應段落。
沒有外掛時,要做出同樣效果得手動替每個標題設錨點、再手刻一份連結清單,文章一多就難以維護,改個標題還可能讓錨點失效。外掛把這整段流程自動化,你只要正常用 H2、H3 寫文章,目錄就會跟著內容自動生成與更新。
對讀者來說,目錄等於一份內文導覽,開始讀之前就能掌握文章涵蓋哪些範圍、要不要繼續看下去。對網站經營者來說,好處有兩層:一是逼自己在寫作時把標題層級理清楚,文章結構自然更有邏輯;二是清楚的標題階層也方便 Google 爬蟲理解頁面架構,部分情況下搜尋結果還會顯示跳轉到特定段落的連結,有機會提升點擊。
WordPress 文章目錄有哪幾種做法
WordPress 要生成文章目錄,常見有三種做法,差別在於手動程度與維護成本。
- 純手動設錨點:自己在每個標題上設好錨點 ID,再手刻一份連結清單。完全不靠外掛,但每改一次標題就要回頭對錨點,文章量一大幾乎無法維護,只適合極少數頁面。
- 外掛搭配手動插入:安裝目錄外掛後,在想放目錄的位置手動插入一段短代碼或區塊。好處是你能精準控制目錄出現在哪篇、哪個位置,缺點是每篇都要記得插。
- 外掛自動生成:安裝外掛後設定好規則(例如「文章類型且標題數達 2 個以上就生成」),之後所有符合條件的文章都會自動長出目錄,不必逐篇處理。這是長期經營部落格最省事的方式,也是本文兩款外掛的主力用法。
Easy Table of Contents 與 LuckyWP Table of Contents 都同時支援自動生成與手動插入,差別在細節設定與介面,下面分別實作。
Easy Table of Contents 怎麼安裝與設定
Easy Table of Contents 是中文圈最多人用的目錄外掛,由 Magazine3 團隊開發,後台已有繁體中文介面,新手最容易上手。它支援文章、頁面與自訂內容類型,也相容於 Gutenberg 區塊編輯器、傳統編輯器,以及 Divi、Elementor、WPBakery 等頁面建構器。
安裝步驟依序是:WordPress 後台 → 外掛 → 安裝外掛,搜尋「Easy Table of Contents」,按立即安裝,再按啟用。啟用後到「設定 → 內容目錄」進入設定頁,設定分成一般設定、內容目錄外觀、進階設定三大區塊。
一般設定是最關鍵的部分,建議重點調整以下幾項。
- 啟用內容目錄的內容類型:勾選「文章」。預設常只勾「頁面」,若你的目錄主要用在部落格文章,記得把文章勾起來。
- 自動插入內容目錄的內容類型:同樣勾「文章」,這樣不必逐篇插短代碼就會自動生成。
- 顯示位置:可選內文第一個標題前、第一個段落後、內文最上方等。最常見是「內文第一個標題前」,目錄出現在開頭。
- 顯示條件:設定文章中標題達幾個才顯示目錄。設成 2 代表有 2 個以上標題才生成,避免短文也硬塞一個只有一項的目錄。
- 標題標籤:目錄上方的標題文字,預設是英文的 Table of Contents,可改成「文章目錄」「內容大綱」等中文字。
內容目錄外觀區塊管的是樣式,包括寬度、對齊方式、字型大小與粗細。最下面的「外觀樣式」要先選「自訂」,下方的背景色彩、框線色彩、標題色彩、連結色彩才會生效,可以調成貼合佈景主題的配色。
進階設定有幾個影響實際運作的選項要注意。
- 錨點小寫與使用連字號:兩者都建議勾選,產生的錨點會是小寫並以連字號分隔,網址較乾淨也較好除錯。
- 標題層級:勾選要納入目錄的層級,一般勾 H2 與 H3 就夠,層級太多目錄會過長。
- 排除的標題:想讓某些標題不進目錄,可在這裡填標題文字,多個用直立線「|」分隔,也支援「*」萬用字元。
- 平滑捲動偏移量:若佈景主題頂端有固定選單,點目錄跳轉後標題會被選單蓋住,把偏移量調高(建議從 30 起,視選單高度增減)就能讓標題停在選單下方。
設定完按儲存,到前台重新整理任一篇符合條件的文章,目錄就會自動出現在你指定的位置。
LuckyWP Table of Contents 怎麼安裝與設定
LuckyWP Table of Contents 的定位是「自動生成加上更細的手動控制」,它完全免費、沒有付費升級版,所有功能在免費版裡都能用,這點和 Easy Table of Contents 的免費加付費分層不同。它同樣支援自動插入,也提供短代碼、Gutenberg 區塊與側邊欄小工具三種手動插入方式。
安裝步驟和前者一樣:後台 → 外掛 → 安裝外掛,搜尋「LuckyWP Table of Contents」,安裝並啟用。啟用後設定頁通常在「設定 → LuckyWP Table of Contents」底下。
設定上 LuckyWP 一樣分成自動插入規則與外觀兩塊。自動插入的部分,先選擇要在哪些內容類型自動產生目錄(例如文章),再設定插入位置與觸發的最少標題數,邏輯與 Easy Table of Contents 接近。
外觀控制是 LuckyWP 比較受好評的地方,寬度、字型大小、顏色、框線都能調,並內建深色、淺色、透明等多組配色方案,想快速套一個現成樣式很方便。要排除特定標題或頁面也做得到,等於在自動生成的便利之外,仍保留逐項微調的空間。
它另一個常被提到的特色是側邊欄小工具。把 LuckyWP 的目錄小工具加進側邊欄後,讀者下滑長文時目錄仍停在側邊,不必回到頂端就能跳段落。Easy Table of Contents 要做到側邊欄固定,通常得另外搭配像 Q2W3 Fixed Widget 這類固定小工具的外掛,LuckyWP 則把目錄小工具直接內建,少裝一個外掛。
設定存檔後,到前台檢查文章與側邊欄是否如預期顯示目錄即可。
Easy Table of Contents 與 LuckyWP 該選哪一款
兩款都免費、都能自動生成目錄、都相容主流佈景主題,差別主要落在中文友善度、付費分層與側邊欄做法上。先看對照表,再依情境決定。
| 比較項目 | Easy Table of Contents | LuckyWP Table of Contents |
|---|---|---|
| 後台繁體中文 | 有完整繁中介面 | 介面以英文為主 |
| 費用 | 免費,另有付費版(約每年 49 美元起) | 完全免費,無付費版 |
| 自動生成 | 支援 | 支援 |
| 手動插入方式 | 短代碼、區塊 | 短代碼、區塊、側邊欄小工具 |
| 側邊欄固定目錄 | 需另裝固定小工具外掛 | 內建側邊欄小工具 |
| 頁面建構器相容 | 明確支援 Divi、Elementor、WPBakery 等 | 相容多數佈景主題 |
| 內建配色方案 | 需自訂顏色 | 內建深色、淺色、透明等多組 |
| 適合對象 | 怕英文、用頁面建構器的新手 | 想免費用滿全部功能、要側邊欄目錄的人 |
選擇邏輯可以這樣抓。如果你是 WordPress 新手、英文不太靈光,或網站是用 Elementor、Divi 這類頁面建構器搭建,Easy Table of Contents 的繁中介面與明確的建構器相容性會讓你少踩坑。如果你想要一款功能全開又不必付費的外掛、特別需要側邊欄常駐目錄,或偏好直接套用現成配色,LuckyWP Table of Contents 會更合手。
兩款不需要同時裝。同一個網站裝兩款目錄外掛,可能在同一篇文章重複輸出兩份目錄、或互相搶錨點,挑一款用到底即可。
目錄不顯示或跳錯位置怎麼處理
裝好外掛後最常遇到的不是設定問題,而是目錄沒出現、或點了跳到錯誤位置。幾個常見狀況與排查方向如下。
目錄完全沒出現,先檢查三件事:內容類型有沒有勾到「文章」、顯示條件設的標題數是不是比文章實際標題數還高(例如條件設 3 但文章只有 2 個 H2)、以及納入目錄的標題層級有沒有對上你實際用的層級。三者只要錯一個,目錄就不會生成。
點目錄跳轉後標題被頂端選單蓋住,這是固定式選單造成的偏移問題。到外掛的平滑捲動偏移量設定把數值調高,讓頁面多捲一段、把標題停在選單下方,數值大小依你選單高度微調。
用頁面建構器寫的標題沒被抓進目錄,原因通常是建構器輸出的標題不是標準 H2、H3 標籤,或目錄外掛讀取的是建構器渲染前的內容。Easy Table of Contents 對 Divi、Elementor 等有明確支援,遇到抓不到時,先確認建構器裡的文字模組確實設成了標題標籤,而不是放大字體的內文。
中文標題的錨點顯示成一串數字或亂碼,這是因為錨點要符合 HTML 規範、只能用英數字元,非 ASCII 的中文標題會改用預設前置詞加數字。這屬正常行為,不影響跳轉功能;若想要可讀的英文錨點,可在外掛設定裡指定錨點前置詞,或在標題裡保留可用的英文字。
裝好目錄外掛之後,下一步該做什麼
挑一款目錄外掛、把內容類型與顯示條件設對,是讓長文變好讀的最低成本投資。新手或用頁面建構器的網站,從繁中介面的 Easy Table of Contents 起步最不容易卡關;想免費用滿功能、又要側邊欄常駐目錄,LuckyWP Table of Contents 更划算。兩款擇一裝好後,真正要花心思的反而是回頭把文章的 H2、H3 標題寫清楚——目錄好不好用,終究取決於底下的標題層級有沒有理順。先把目錄跑起來,再用它檢視自己每篇文章的結構是否一目了然,這才是目錄外掛對網站最實際的價值。