原名“Discourse 分类侧边栏”——由于该主题组件现已支持分类和标签,其名称已更新为 Topic List Sidebars(主题列表侧边栏)。
| 摘要 | Topic List Sidebars 选取一个主题,并将其作为分类或标签的主题列表侧边栏。 | |
| 预览 | 在 Discourse 主题创建器上预览 | |
| 仓库链接 | https://github.com/discourse/discourse-topic-list-sidebars | |
| Discourse 主题新手? | Discourse 主题使用入门指南 |
安装此主题组件
功能特性
此主题组件选取一个主题,并将其作为分类或标签的主题列表侧边栏。这些侧边栏仅在浏览器窗口宽度为 767px 或更宽时可见(大多数平板电脑和显示器)。
我可以利用此主题组件做什么?
-
选择一个主题,并将其内容显示为分类或标签的侧边栏。
-
通过在设置中将分类名称设置为
all,可将侧边栏显示在 /latest、/new、/unread 和 /top 页面上。 -
选择侧边栏出现在主题列表的左侧还是右侧。
-
默认情况下,除非子分类定义了其自己的侧边栏,否则分类的侧边栏也会在其所有子分类中显示(您可以通过取消选中
inherit parent sidebar设置来禁用此行为)。
如何配置?
选择您的分类和标签,并添加您希望用于填充侧边栏内容的主题 ID(例如 example.com/t/example-topic/57)。
我建议在其各自的分类/标签中创建侧边栏主题,关闭该主题以禁止回复,并将其从列表中隐藏(这样它就不会出现在主题列表中)。
请注意,您不能将私有分类中的主题用作公共分类的侧边栏(虽然技术上可以,但没有该私有主题访问权限的用户只会看到一个空的侧边栏!)。
设置
| 名称 | 描述 |
|---|---|
| sidebars | 添加和删除侧边栏 |
| sidebar side | 选择左侧或右侧 |
| inherit parent sidebar | 如果选中,子分类将继承其父分类的侧边栏(除非子分类已分配了侧边栏)。 如果未选中,则仅当指定了侧边栏时,子分类才会显示侧边栏。 |
| stick on scroll | 如果选中,侧边栏在滚动时将保持固定位置 |
开发者说明
每个分类侧边栏都包裹在一个包含分类缩写(slug)的类中,因此对于 staff 分类,该类为 .category-sidebar-staff。您可以使用这些类来单独设置侧边栏的样式。
带有侧边栏的页面的 body 标签也添加了一个类,因此您可以使用 body.custom-sidebar 为所有带有侧边栏的页面应用样式。
致谢
特别感谢 @xrav3nz 为奠定此组件的基础所做的贡献!
由我们托管? 主题组件在我们的 Standard、Business 和 Enterprise 计划中均可使用。

