原名“Discourse 类别侧边栏”——鉴于该主题组件现已同时支持类别和标签，其名称已更新为 主题列表侧边栏。
 |
摘要 | 主题列表侧边栏 选取一个主题，并将其作为类别或标签的主题列表的侧边栏应用。 |
 |
预览 | 在 Discourse 主题创建器中预览 |
 |
仓库链接 | https://github.com/discourse/discourse-topic-list-sidebars |
 |
Discourse 主题新手？ | Discourse 主题使用入门指南 |
安装此主题组件
功能
该主题组件选取一个主题，并将其作为类别或标签的主题列表的侧边栏应用。这些侧边栏仅在浏览器宽度为 767px 或更宽时可见（大多数平板电脑和显示器）。
我可以利用此主题组件做什么？
-
选择一个主题并将其内容显示为类别或标签的侧边栏。
-
通过在设置中将类别名称设为
all，将侧边栏设置显示在 /latest、/new、/unread 和 /top 页面上。 -
选择侧边栏显示在主题列表的左侧或右侧。
-
默认情况下，类别的侧边栏也会显示在其所有子类别中，除非子类别已定义了自己的侧边栏（您可以通过取消勾选
继承父级侧边栏设置来禁用此功能）。
如何配置？
选择您的类别和标签，并添加您希望用于填充侧边栏内容的主题 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 为此组件的实现奠定了坚实的基础！
由我们托管？ 主题组件可在我们的标准版、商业版和企业版计划中使用。