外掛說明
cclin Smart Table of Contents 是一款輕量且具彈性的目錄外掛，專為長篇內容、教學文章與文件型網站設計。
本外掛著重於閱讀體驗、內容結構與導覽清晰度，適用於部落格、技術文章與知識庫網站。
主要特色
- 自動擷取 H2 至 H6 標題（可自訂）
- 清晰且具層級結構的目錄輸出
- 自動標題編號（範例：1、1.1、1.1.1）
- 平滑滾動導覽
- 支援滾動時自動高亮目前標題
- 多種顯示位置：
- 文章頂部內嵌目錄
- 固定側邊欄目錄
- 不同目錄模式可獨立控制展開／收合
- 自動插入目錄至文章內容
- 支援自訂文章類型（CPT）
- 相容 Gutenberg（可與區塊編輯器無縫運作）
- 完整支援國際化（i18n）
- 輕量且結構清晰的物件導向架構
適用場景
cclin Smart Table of Contents 特別適用於：
- 長篇部落格文章
- 技術教學文章
- 文件型網站
- 知識庫系統
- 結構化學術或研究內容
自訂設定
本外掛不要求使用者撰寫自訂 CSS，而是提供結構化設定選項，例如：
- 標題層級選擇
- 項目符號與編號開關
- 顯示位置控制
- 固定偏移設定
- 展開／收合行為設定
在維持效能與相容性的同時，兼顧彈性與穩定性。
第三方函式庫
本外掛包含以下第三方函式庫：
- Select2（https://github.com/select2/select2)
授權：MIT
授權檔案位置：/assets/vendor/select2/LICENSE
螢幕擷圖
文章內目錄自動插入於文章頂部 
左側固定浮動顯示的側邊目錄 
後台介面：基本設定與顯示位置設定 
後台介面：標題與列表樣式、外觀與顏色（即時預覽） 
後台介面：自訂外觀與顏色（即時預覽）
適用於區塊編輯器
這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。
- Ccstoc Toc
安裝方式
- 將外掛資料夾
cclin-smart-toc上傳至/wp-content/plugins/ - 在 WordPress「外掛」選單中啟用外掛
- 前往「設定 cclin Smart TOC」進行設定
常見問題集
-
此外掛支援 Gutenberg 區塊編輯器嗎？
-
是的，目錄會在前端自動渲染，並可與 Gutenberg 區塊正常運作。
-
我可以控制要包含哪些層級的標題嗎？
-
可以，您可選擇要包含的標題層級（H2–H6）。
-
我可以關閉自動插入嗎？
-
可以，您可關閉自動插入，改用手動放置。
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.0.2
- 修正 CSS 版面配置問題
1.0.1
- 移除自訂 CSS 功能
- 提升安全性相容
- 程式碼小幅整理
1.0.0
- 初始版本發布