cclin Smart Table of Contents

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