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等關閉模板。結尾後仍有額外發言時,可能不視為整個話題結束;普通文字「已結案」、局部折疊及任意自訂模板不保證能被識別。請依社群慣例標記整段討論,不要為改變列表外觀而關閉尚未結束的討論。 - 討論已移出來源頁後,該列可能隨下次更新移除;本模板不另保存歷史主題。
- 若資料頁存在但機器人停機、設定尚未生效或資料尚未更新,本模板仍會顯示現有內容;資料頁存在不代表機器人目前正常運行。
首次啟用與避免遞迴
[编辑]- 先建立「討論頁/topic list」子頁,留空亦可。Cewbot使用不自動建立頁面的編輯選項。
- 確認討論頁列於User:Cewbot/討論頁面主題列表設定的
listen_to_pages。新增監聽頁面須依設定頁說明等候機器人重新載入或由操作者重啟。 - 在討論頁加入
{{Topic list}};在頁首子模板引用時,請指定page。 - 確認Cewbot已成功寫入資料頁,再測試排序、摺疊與主題連結。
不要把本模板放到它讀取的資料子頁內,也不要讓list指回主模板或包含本模板的頁面,以免產生遞迴。
樣式與相容性
[编辑]本模板使用 TemplateStyles,以 Codex 的文字、背景、邊框及焦點色彩變數配合備援色,隨網站淺色、深色及跟隨系統模式切換。
相容層依據 Cewbot 目前的內嵌色碼將狀態色換成主題色;只作用於本模板內。必要的 !important 用來覆蓋機器人既有的內嵌樣式。若機器人改動色碼、欄位或狀態格式,請同步檢查樣式及圖例。支援目前設定頁的短十六進位色碼及等值六位色碼;任意其他色碼不在此相容範圍。
窄螢幕保留完整表格並提供區域橫向捲動;保留表格語意及所有欄位。鍵盤使用者可聚焦表格區域並左右捲動。
本模板子頁面
[编辑]- Template:Topic list/render:主要顯示子模板
- Template:Topic list/styles.css:CSS樣式
TemplateData
[编辑]顯示 Cewbot 自動更新的討論主題列表;資料來自討論頁的 /topic list 子頁。
| 参数 | 描述 | 类型 | 状态 | |
|---|---|---|---|---|
| 討論頁 | page 1 | 含命名空間的完整討論頁名稱,不含 /topic list。 | 页面名称 | 推荐 |
| 資料子頁 | list | 完整資料頁名稱;優先於討論頁參數。 | 页面名称 | 可选 |
| 標題 | title | 无描述
| 字符串 | 可选 |
| 隱藏時間圖例 | no_time_legend | 任意非空值(包括 0)皆隱藏;留空顯示。 | 字符串 | 可选 |