此主题组件允许您在 Discourse 中高亮显示一个或多个类别。您可以:
- 为特定类别设置特殊的背景样式
- 在标题栏中添加具有相同特殊样式的类别链接
一个典型的使用场景是用于包含“高级(Premium)”内容的类别。
类别导航与标题标签
类别页面
配置
类别高亮主题组件有一个主要设置:“高亮类别(highlight categories)”。您可以在“类别高亮器”主题组件的设置面板中找到该设置。
每个您希望高亮的类别在该设置中都有对应的列表项。每个项目的格式如下:
category_slug~background~text_color~header_label~header_label_mobile~parent_slug~alternate_link
该格式的一个示例如下:
premium~linear-gradient(319deg, #cdedfd 0%, #ffec82 37%, #ffcfd2 100%)~#88562e~:star:\u0026nbsp\u0026nbspPremium~:star:
共有六个可能的值,每个值之间用 ~(波浪号)分隔。让我们依次查看每个值。
类别 Slug
这是您希望高亮的类别的“slug”。您可以在类别设置中找到它。
如果您需要高亮一个子类别,则需要使用“父”类别的 slug,后跟子类别的 slug,两者之间用 / 分隔。
例如,如果有一个名为 videos 的 premium 子类别,且您希望高亮它,则应使用:
premium/videos
权限
请注意,只有对高亮类别拥有 read 权限的用户才能看到高亮效果,包括标题栏标签。您可以在类别的“安全”设置中更改类别权限。
背景
这是一个将应用于类别徽章 background CSS 属性的值。您可以使用任何该属性支持的条目。
background - CSS: 层叠样式表 | MDN
background 简写 CSS 属性可同时设置所有背景样式属性,例如颜色、图像、原点、大小或重复方法。
例如:linear-gradient(319deg, #cdedfd 0%, #ffec82 37%, #ffcfd2 100%)。
文本颜色
这是一个将应用于类别徽章 color CSS 属性的值。这将影响文本的颜色。您可以使用任何该属性支持的条目。
color - CSS: 层叠样式表 | MDN
color CSS 属性设置元素文本及其文本装饰的前景色值,并设置 currentcolor 值。currentcolor 可用作其他属性的间接值,并且是其他颜色属性(如…)的默认值。
在我们的示例中,该值为 #88562e。
标题标签
该值有两个作用。它决定了:
- 高亮类别是否显示标题标签;以及
- 该标签的内容。
如果您不需要标题标签,则完全不要包含此值。
该值支持文本、HTML 实体和表情符号。
此处标题标签的值为::star:\u0026nbsp\u0026nbspPremium。这包括:
- 星星表情符号的短代码:
:star: - 两个不换行空格 HTML 实体(每个添加一个空格):
\u0026nbsp\u0026nbsp - 我们的标签文本:
Premium
您可以在这里找到完整的 表情符号短代码列表,以及完整的 HTML 实体列表。
移动端标题标签
该值也有两个作用。它决定了:
- 高亮类别是否显示移动端标题标签;以及
- 移动端标题标签的内容。
其用法和格式与标题标签相同。需要注意的是,移动端的可用空间较少,因此明智的做法是仅使用一个表情符号或简短单词以节省空间。
父类别
您可以通过设置项目的“父级”来在标题栏中创建一个下拉菜单。在第六个位置插入一个类别 slug,相应的项目将成为该类别在标题栏中的子菜单项。与第一个项目一样,请确保在此处使用类别 slug,您可以从类别设置对话框中获取该 slug。
替代链接
默认情况下,每个类别项链接到其对应的类别。您可以通过在设置块的第六个位置添加 URL 来更改链接。







