模板: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 子页。