主题列表侧边栏

:information_source: 原名“Discourse 分类侧边栏”——由于该主题组件现已支持分类和标签,其名称已更新为 Topic List Sidebars(主题列表侧边栏)

:discourse2: 摘要 Topic List Sidebars 选取一个主题,并将其作为分类或标签的主题列表侧边栏。
:eyeglasses: 预览 在 Discourse 主题创建器上预览
:hammer_and_wrench: 仓库链接 https://github.com/discourse/discourse-topic-list-sidebars
:open_book: 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 为所有带有侧边栏的页面应用样式。

致谢

:heart: 特别感谢 @xrav3nz 为奠定此组件的基础所做的贡献!


:discourse2: 由我们托管? 主题组件在我们的 Standard、Business 和 Enterprise 计划中均可使用。

59 个赞