模板:Topic list/doc

此頁面是Template:Topic list的模板文件。
此頁面可能包含了模板的使用說明、分類和其他內容。

本模板使用以下模板樣式：

此模板引用其他模板：

本模板顯示由Cewbot產生的討論主題列表，提供可排序及摺疊的表格、發言時間圖例與深色模式配色。

用法

在已啟用 Cewbot 主題列表的討論頁加入：

{{Topic list}}

預設讀取「目前完整頁名/topic list」。在頁首子模板或其他頁面引用時，請明確指定討論頁，避免讀取錯誤的子頁：

{{Topic list|page=Wikipedia talk:2026年AI调查}}

亦可使用第一個位置參數：

{{Topic list|Wikipedia talk:2026年AI调查}}

指定資料頁及隱藏時間圖例：

{{Topic list
 |list=Wikipedia talk:2026年AI调查/topic list
 |title=AI 調查討論主題
 |no_time_legend=1
}}

參數	預設	說明
`page` 或 `1`	目前完整頁名	討論頁的完整名稱（含命名空間）。不要加 `/topic list`。`page` 優先於位置參數；明確留空 `page` 時改用目前頁名。
`list`	`page/topic list`	完整資料子頁名；非空白時優先於 `page`。
`title`	討論主題	區塊標題。
`no_time_legend`	空白	任意非空值均隱藏時間圖例，沿用原有參數習慣；`0` 也會隱藏。欄位及狀態說明仍顯示。

Cewbot 讀取討論頁並重建 /topic list 子頁；本模板只嵌入該子頁。新增、移除及封存討論後，列表須待機器人成功更新及頁面快取更新才會反映，並非即時更新。
在討論頁中正常新增或移除主題，無須在本模板手動維護每列資料。不要直接修改機器人產生的表格，否則可能在下次更新時遭覆寫。
保留 Cewbot 輸出的數值、簽名統計、連結錨點、data-sort-value、排序及摺疊功能。簽名數不等於精確發言次數；漏簽名或非標準簽名可能影響統計。
目前 Cewbot 設定以刪除線同時標示「已關閉」及「已移動」，本模板保留該判定，不把兩者誤分為不同狀態。CSS 不會自行解析討論內容。
公開程式碼會辨識 Archive top/Archive bottom、Atop/Abot 等關閉模板。結尾後仍有額外發言時，可能不視為整個話題結束；普通文字「已結案」、局部折疊及任意自訂模板不保證能被識別。請依社群慣例標記整段討論，不要為改變列表外觀而關閉尚未結束的討論。
討論已移出來源頁後，該列可能隨下次更新移除；本模板不另保存歷史主題。
若資料頁存在但機器人停機、設定尚未生效或資料尚未更新，本模板仍會顯示現有內容；資料頁存在不代表機器人目前正常運行。

不要把本模板放到它讀取的資料子頁內，也不要讓list指回主模板或包含本模板的頁面，以免產生遞迴。

本模板使用 TemplateStyles，以 Codex 的文字、背景、邊框及焦點色彩變數配合備援色，隨網站淺色、深色及跟隨系統模式切換。

相容層依據 Cewbot 目前的內嵌色碼將狀態色換成主題色；只作用於本模板內。必要的 !important 用來覆蓋機器人既有的內嵌樣式。若機器人改動色碼、欄位或狀態格式，請同步檢查樣式及圖例。支援目前設定頁的短十六進位色碼及等值六位色碼；任意其他色碼不在此相容範圍。

窄螢幕保留完整表格並提供區域橫向捲動；保留表格語意及所有欄位。鍵盤使用者可聚焦表格區域並左右捲動。

顯示 Cewbot 自動更新的討論主題列表；資料來自討論頁的 /topic list 子頁。