啟用手動目錄輸出可讓你透過範本函式、簡碼或區塊放置目錄。
當你希望把目錄放入主題模板時，範本函式會很實用。
當你希望把目錄放入內容區或簡碼區塊時，簡碼會很實用。
當你希望在區塊編輯器中以可視方式放置目錄時，區塊會很實用。

範本函式：

<?php if ( function_exists( 'airygen_the_toc' ) ) { airygen_the_toc(); } ?>

簡碼：

[airygen_toc]

區塊：

<!-- wp:airygen/toc /-->

自動插入

啟用自動目錄插入會把目錄自動插入符合條件的文章。
插入位置支援內容前與第一段之後。

區塊標題

標題可決定目錄是否顯示可見標題。
標題文字欄位可更改清單上方顯示的文案。
標題層級欄位可更改該標題使用的 HTML 標題層級。

範圍

要包含的文章類型用來決定哪些內容類型符合目錄輸出資格。

結構

最少標題數會在文章標題數量不足時隱藏目錄。
標題層級可讓你決定目錄要包含 H2、H3 與 H4。

行為

平滑捲動會在讀者點擊目錄連結時加入平滑捲動效果。
加入編號會把清單改成編號式大綱。
載入時收合會讓目錄在初始載入時維持收合狀態。

錨點

錨點前綴會為產生的標題 ID 加上前綴，避免與頁面其他錨點衝突。
排除標題可讓你用逗號分隔輸入要跳過的標題文字。

版面配置分頁

這個分頁用來調整目錄的視覺樣式。

主題

雪白石板會套用中性的白色與石板灰風格。
蜂蜜紙會帶來溫暖的紙張風格。
天空微風會帶來淺藍色外觀。
薄荷寧靜會帶來柔和的綠色外觀。
玫瑰腮紅會帶來偏柔和的粉色外觀。
薰衣草霧會帶來淡紫色外觀。

樣式

標頭控制項可調整標題容器的邊框寬度、邊框樣式、圓角、邊框顏色、內距、外距、背景色、標題顏色、標題字級與標題字體樣式。
主體控制項可調整目錄容器的邊框寬度、邊框樣式、圓角、邊框顏色、內距、外距與背景色。
連結控制項可調整目錄連結顏色、字級，以及粗體、斜體或底線樣式。
清單控制項可調整目錄清單使用的內部縮排。

預覽分頁

這個分頁可讓你在筆記型電腦、平板電腦與手機預覽中檢查目錄效果。

預覽刻意保持簡潔。
啟用中的主題仍可能影響最終前台輸出。
畫面也會顯示產生的 HTML 與 CSS 範例。

編輯器面板

在區塊編輯器中，目錄面板可讓你只為單篇文章控制這個功能，而不必改動全站預設值。

目錄顯示模式支援自動、手動與停用。
當模式為手動時，面板會顯示插入目錄按鈕，讓你插入區塊或簡碼。

如何使用

開啟 Airygen SEO -> 設定 -> 目錄。
在設定分頁中，決定要使用啟用手動目錄輸出、啟用自動目錄插入，或只保留其中一種方式。
如果你要手動放置目錄，請開啟手動輸出，並複製符合工作流程的範本函式、簡碼或區塊片段。
如果你要自動放置目錄，請開啟自動插入，並選擇內容前或第一段之後作為插入位置。
如果你希望目錄有可見標題，請開啟標題顯示，並設定標題文字與標題層級。
在範圍中，選擇哪些文章類型可以顯示目錄。
在結構中，設定最少標題數，並選擇要納入的標題層級。
在行為中，決定是否啟用平滑捲動、編號與預設收合模式。
在錨點中，設定錨點前綴，並列出要排除的標題。
開啟版面配置，選擇一組預設主題，並細調標題區、內容容器、連結與清單間距。
如有需要，請開啟特定文章的編輯器，使用目錄顯示模式將該文章切換為自動、手動或停用。
儲存設定、檢查預覽分頁，然後再開啟一篇有足夠標題的正式文章確認最終結果。

儲存後請確認以下項目：

只有符合最少標題數的文章才會顯示目錄。
點擊目錄連結後，讀者會被帶到正確段落。
單篇文章的目錄顯示模式與你為該篇文章選擇的方法一致。
套用主題 CSS 後，正式頁面外觀仍然正確。

SEO 效益

好的目錄能讓長篇內容更容易掃讀，也更容易導覽。這能幫助讀者更快到達需要的段落，並讓長文頁面呈現更清楚的結構。

使用情境

長篇教學文章

調整前：安裝指南有很多段落，但讀者必須一路往下捲動，才能找到需要的步驟。

調整後：目錄把標題轉成可點擊大綱，讓讀者可以直接跳到安裝、範例或疑難排解段落。

文件與知識庫頁面

調整前：支援文件已經有清楚標題，但第一次閱讀的使用者仍會覺得頁面資訊量很重。

調整後：目錄會立即把頁面結構顯示出來，讓讀者在深入閱讀前就能先掌握頁面全貌。

常見問題

為什麼有些文章沒有顯示目錄？

請檢查最少標題數、所選的標題層級、允許的文章類型，以及單篇文章的目錄顯示模式。

我該用自動插入還是手動放置？

如果你希望大量文章都自動加入目錄，請用自動插入。若你需要精準控制顯示位置，請使用手動放置。

為什麼預覽與正式頁面不同？

預覽是簡化版參考畫面。你的主題與真實文章內容仍會影響前台最終結果，因此一定要檢查正式頁面。

概覽

設定

設定 分頁

手動輸出